Fungsi RpcBindingInqAuthInfoExA (rpcdce.h)

Artikel
03/15/2023

Fungsi RpcBindingInqAuthInfoEx mengembalikan informasi autentikasi, otorisasi, dan kualitas layanan keamanan dari handel pengikatan.

Sintaks

RPC_STATUS RpcBindingInqAuthInfoExA(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc,
  unsigned long            RpcQosVersion,
  RPC_SECURITY_QOS         *SecurityQOS
);

Parameter

Binding

Handel pengikatan server dari mana informasi autentikasi dan otorisasi dikembalikan.

ServerPrincName

Mengembalikan penunjuk ke penunjuk ke nama utama server yang diharapkan yang dirujuk dalam Pengikatan. Konten nama yang dikembalikan dan sintaksnya ditentukan oleh layanan autentikasi yang digunakan.

Tentukan nilai null untuk mencegah RpcBindingInqAuthInfoEx mengembalikan parameter ServerPrincName . Dalam hal ini, aplikasi tidak memanggil fungsi RpcStringFree .

AuthnLevel

Mengembalikan penunjuk yang diatur ke tingkat autentikasi yang digunakan untuk panggilan prosedur jarak jauh yang dilakukan menggunakan Pengikatan. Untuk daftar tingkat autentikasi yang didukung RPC, lihat Konstanta Tingkat Autentikasi. Tentukan nilai null untuk mencegah fungsi mengembalikan parameter AuthnLevel .

Tingkat yang dikembalikan dalam parameter AuthnLevel mungkin berbeda dari tingkat yang ditentukan ketika klien memanggil fungsi RpcBindingSetAuthInfoEx . Perbedaan ini terjadi ketika pustaka run-time RPC tidak mendukung tingkat autentikasi yang ditentukan oleh klien dan secara otomatis meningkatkan ke tingkat autentikasi yang lebih tinggi berikutnya.

AuthnSvc

Mengembalikan penunjuk yang diatur ke layanan autentikasi yang ditentukan untuk panggilan prosedur jarak jauh yang dilakukan menggunakan Pengikatan. Untuk daftar layanan autentikasi yang didukung RPC, lihat Konstanta Layanan Autentikasi.

Tentukan nilai null untuk mencegah RpcBindingInqAuthInfoEx mengembalikan parameter AuthnSvc .

AuthIdentity

Mengembalikan penunjuk ke handel ke struktur data yang berisi kredensial autentikasi dan otorisasi klien yang ditentukan untuk panggilan prosedur jarak jauh yang dilakukan menggunakan Pengikatan.

Tentukan nilai null untuk mencegah RpcBindingInqAuthInfoEx mengembalikan parameter AuthIdentity .

AuthzSvc

Mengembalikan pointer yang diatur ke layanan otorisasi yang diminta oleh aplikasi klien yang melakukan panggilan prosedur jarak jauh pada Pengikatan. Untuk daftar layanan autentikasi yang didukung RPC, lihat Konstanta Layanan Autentikasi.

Tentukan nilai null untuk mencegah RpcBindingInqAuthInfoEx mengembalikan parameter AuthzSvc .

RpcQosVersion

Meneruskan nilai versi saat ini (diperlukan untuk kompatibilitas penerusan jika ekstensi dibuat untuk fungsi ini). Selalu atur parameter ini ke RPC_C_SECURITY_QOS_VERSION.

SecurityQOS

Mengembalikan penunjuk ke struktur RPC_SECURITY_QOS , yang menentukan pengaturan kualitas layanan.

Mengembalikan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_BINDING	Handel pengikatan tidak valid.
RPC_S_WRONG_KIND_OF_BINDING	Ini adalah jenis pengikatan yang salah untuk operasi.
RPC_BINDING_HAS_NO_AUTH	Pengikatan tidak memiliki informasi autentikasi.

Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.

Keterangan

Aplikasi klien memanggil fungsi RpcBindingInqAuthInfoEx untuk melihat informasi autentikasi dan otorisasi yang terkait dengan handel pengikatan server. Fungsi ini menyediakan kemampuan untuk menanyakan tentang kualitas keamanan layanan pada handel pengikatan. Sebaliknya identik dengan RpcBindingInqAuthInfo.

Pustaka run-time RPC mengalokasikan memori untuk parameter ServerPrincName yang dikembalikan. Aplikasi bertanggung jawab untuk memanggil fungsi RpcStringFree untuk string argumen yang dikembalikan.

Catatan

Header rpcdce.h mendefinisikan RpcBindingInqAuthInfoEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Lihat juga

RPC_SECURITY_QOS

RpcBindingSetAuthInfoEx

RpcStringFree