Fungsi RpcCertGeneratePrincipalNameW (rpcssl.h)

Program server menggunakan fungsi RpcCertGeneratePrincipalName untuk menghasilkan nama utama untuk sertifikat keamanan.

Sintaks

RPC_STATUS RpcCertGeneratePrincipalNameW(
  PCCERT_CONTEXT Context,
  DWORD          Flags,
  RPC_WSTR       *pBuffer
);

Parameter

Context

Arahkan ke konteks sertifikat keamanan.

Flags

Saat ini, satu-satunya bendera yang valid untuk parameter ini adalah RPC_C_FULL_CERT_CHAIN. Menggunakan bendera ini menyebabkan nama utama dihasilkan dalam format penuh.

pBuffer

Arahkan ke penunjuk. Fungsi RpcCertGeneratePrincipalName mengatur ini untuk mengarahkan ke string yang dihentikan null yang berisi nama utama.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Keterangan

Secara default, nama utama yang diteruskan oleh fungsi RpcCertGeneratePrincipalName dalam format msstd. Untuk menghasilkan nama dalam format penuh, teruskan RPC_C_FULL_CERT_CHAIN sebagai nilai untuk parameter Bendera .

Aplikasi Anda harus memanggil RpcStringFree untuk merilis memori untuk string yang berisi nama utama.

Catatan

Header rpcssl.h mendefinisikan RpcCertGeneratePrincipalName 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	rpcssl.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Lihat juga

Nama Utama

RpcStringFree