Fungsi RpcCertGeneratePrincipalName (rpcssl.h)
Program server menggunakan fungsi RpcCertGeneratePrincipalName untuk menghasilkan nama utama untuk sertifikat keamanan.
Sintaks
RPC_STATUS RpcCertGeneratePrincipalName(
PCCERT_CONTEXT Context,
DWORD Flags,
RPC_CSTR *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
Penunjuk ke penunjuk. Fungsi RpcCertGeneratePrincipalName mengatur ini untuk mengarahkan string yang dihentikan null yang berisi nama utama.
Menampilkan nilai
Fungsi ini tidak mengembalikan nilai.
Keterangan
Secara default, nama utama yang diteruskan kembali 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.
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 | rpcssl.h (termasuk Rpc.h) |
| Pustaka | Rpcrt4.lib |
| DLL | Rpcrt4.dll |