Fungsi RpcMgmtInqServerPrincNameW (rpcdce.h)

Artikel
03/04/2024

Fungsi RpcMgmtInqServerPrincName mengembalikan nama utama server.

Sintaks

RPC_STATUS RpcMgmtInqServerPrincNameW(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_WSTR           *ServerPrincName
);

Parameter

Binding

Untuk menerima nama utama untuk server, tentukan handel pengikatan server untuk server tersebut. Untuk menerima nama utama untuk aplikasi Anda sendiri (lokal), tentukan nilai NULL.

AuthnSvc

Layanan autentikasi tempat nama utama dikembalikan. Nilai yang valid adalah konstanta untuk penyedia keamanan yang valid.

ServerPrincName

Mengembalikan nama utama yang terdaftar untuk layanan autentikasi di AuthnSvc oleh server yang direferensikan dalam Pengikatan. Jika beberapa nama terdaftar, hanya satu nama yang dikembalikan.

Nilai kembali

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.

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

Keterangan

Aplikasi memanggil fungsi RpcMgmtInqServerPrincName untuk mendapatkan nama utama server yang terdaftar untuk layanan autentikasi tertentu.

Pustaka run-time RPC mengalokasikan memori untuk string yang dikembalikan di ServerPrincName. Aplikasi bertanggung jawab untuk memanggil fungsi RpcStringFree untuk merilis memori yang digunakan oleh fungsi ini.

Server harus mendengarkan panggilan prosedur jarak jauh agar fungsi ini berhasil. Jika server tidak mendengarkan, fungsi gagal.

Catatan

Header rpcdce.h mendefinisikan RpcMgmtInqServerPrincName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscessor 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

Persyaratan	Nilai
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

RpcStringFree

Bagikan melalui