Fungsi RpcNsBindingInqEntryNameA (rpcdce.h)

Artikel
03/01/2024

Fungsi RpcNsBindingInqEntryName mengembalikan nama entri tempat handel pengikatan datang.

Catatan Fungsi ini tidak didukung pada Windows Vista dan sistem operasi yang lebih baru.

Sintaks

RPC_STATUS RpcNsBindingInqEntryNameA(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_CSTR           *EntryName
);

Parameter

Binding

Handel pengikatan yang nama entri database layanan-namanya dikembalikan.

EntryNameSyntax

Sintaks yang digunakan dalam EntryName.

Untuk menggunakan sintaks yang ditentukan dalam entri nilai registri

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, berikan nilai RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Mengembalikan alamat penunjuk ke nama entri database layanan-nama tempat Pengikatan ditemukan.

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

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_BINDING	Handel pengikatan tidak valid.
RPC_S_NO_ENTRY_NAME	Tidak ada nama entri untuk pengikatan.
RPC_S_INVALID_NAME_SYNTAX	Sintaks nama tidak valid.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Sintaks nama tidak didukung.
RPC_S_INCOMPLETE_NAME	Nama tidak lengkap.

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

Keterangan

Fungsi RpcNsBindingInqEntryName mengembalikan nama nama entri layanan–database tempat handel pengikatan klien kompatibel.

Pustaka run-time RPC mengalokasikan memori untuk string yang dikembalikan dalam parameter EntryName . Aplikasi ini bertanggung jawab untuk memanggil fungsi RpcStringFree untuk membatalkan alokasi memori tersebut.

Nama entri hanya dikaitkan dengan handel pengikatan yang dikembalikan dari fungsi RpcNsBindingImportNext, RpcNsBindingLookupNext, dan RpcNsBindingSelect .

Jika handel pengikatan yang ditentukan dalam parameter Pengikatan tidak dikembalikan dari entri database layanan-nama (misalnya, jika handel pengikatan dibuat dengan memanggil RpcBindingFromStringBinding), RpcNsBindingInqEntryName mengembalikan string kosong ("\0") dan kode status RPC_S_NO_ENTRY_NAME.

Catatan

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

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree

Bagikan melalui