Fungsi RpcServerInqDefaultPrincName (rpcdce.h)

Fungsi RpcServerInqDefaultPrincName mendapatkan nama utama default untuk layanan autentikasi tertentu.

Sintaks

RPC_STATUS RpcServerInqDefaultPrincName(
  unsigned long AuthnSvc,
  RPC_WSTR      *PrincName
);

Parameter

AuthnSvc

Layanan autentikasi untuk digunakan ketika server menerima permintaan untuk panggilan prosedur jarak jauh.

PrincName

Setelah berhasil, berisi nama utama default untuk layanan autentikasi yang diberikan seperti yang ditentukan oleh parameter AuthnSvc . Layanan autentikasi yang digunakan menentukan konten nama dan sintaksnya. Nama utama ini harus digunakan sebagai parameter ServerPrincName dari fungsi RpcServerRegisterAuthInfo . Jika fungsi berhasil, PrincName harus dibebaskan menggunakan fungsi RpcStringFree . Jika fungsi gagal, konten PrincName tidak terdefinisi dan pemanggil tidak memiliki kewajiban untuk membebaskannya.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_OUT_OF_MEMORY	Memori tidak cukup untuk menyelesaikan operasi.

 

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

 

Keterangan

Fungsi ini adalah cara yang disarankan untuk mendapatkan nama utama server untuk diteruskan ke fungsi RpcServerRegisterAuthInfo . Meskipun menyusun nama utama server dimungkinkan tanpa menggunakan fungsi ini, memanggil fungsi lebih mudah dan lebih portabel di seluruh versi sistem operasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Lihat juga

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo