Fungsi RpcServerInqDefaultPrincNameW (rpcdce.h)
Fungsi RpcServerInqDefaultPrincName mendapatkan nama utama default untuk layanan autentikasi tertentu.
Sintaks
RPC_STATUS RpcServerInqDefaultPrincNameW(
unsigned long AuthnSvc,
RPC_WSTR *PrincName
);
Parameter
AuthnSvc
Layanan autentikasi yang akan 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 dikosongkan menggunakan fungsi RpcStringFree . Jika fungsi gagal, konten PrincName tidak terdefinisi dan pemanggil tidak memiliki kewajiban untuk membebaskannya.
Nilai kembali
Nilai | Makna |
---|---|
|
Panggilan berhasil. |
|
Memori tidak cukup untuk menyelesaikan operasi. |
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.
Catatan
Header rpcdce.h mendefinisikan RpcServerInqDefaultPrincName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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 [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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk