Bagikan melalui

Fungsi RpcNsEntryExpandNameA (rpcnsi.h)

  • Artikel

Fungsi RpcNsEntryExpandName memperluas nama entri layanan-nama. Fungsi ini didukung oleh Direktori Aktif.

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

Sintaks

RPC_STATUS RpcNsEntryExpandNameA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_CSTR      *ExpandedName
);

Parameter

EntryNameSyntax

Sintaks 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

Arahkan ke nama entri untuk diperluas.

ExpandedName

Mengembalikan penunjuk ke penunjuk ke versi EntryName yang diperluas.

Nilai kembali

Nilai Makna
RPC_S_OK
 Panggilan berhasil.
RPC_S_INCOMPLETE_NAME
 Nama tidak lengkap.
 
Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.
 

Keterangan

Aplikasi memanggil fungsi RpcNsEntryExpandName untuk mendapatkan nama entri yang sepenuhnya diperluas.

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

Akun nama entri yang diperluas yang dikembalikan untuk terjemahan nama lokal dan untuk perbedaan dalam skema penamaan yang ditentukan secara lokal.

Catatan Fungsi ini memerlukan dukungan Direktori Aktif.
 

Catatan

Header rpcnsi.h mendefinisikan RpcNsEntryExpandName 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

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 rpcnsi.h (termasuk Rpc.h)
Pustaka Rpcns4.lib
DLL Rpcns4.dll

Lihat juga

RpcStringFree