rpcCertGeneratePrincipalName 函式 (rpcssl.h)
伺服器程式會使用 RpcCertGeneratePrincipalName 函式來產生安全性憑證 的主體名稱 。
語法
RPC_STATUS RpcCertGeneratePrincipalName(
PCCERT_CONTEXT Context,
DWORD Flags,
RPC_CSTR *pBuffer
);
參數
Context
安全性憑證內容的指標。
Flags
目前,此參數的唯一有效旗標是RPC_C_FULL_CERT_CHAIN。 使用此旗標會導致主體名稱以 fullsic 格式產生。
pBuffer
指標的指標。 RpcCertGeneratePrincipalName函式會將這個 設定為指向包含主體名稱的 Null 終止字串。
傳回值
此函式不會傳回值。
備註
根據預設, RpcCertGeneratePrincipalName 函式傳回的主體名稱是 msstd 格式。 若要以 fullsic 格式產生名稱,請傳遞 RPC_C_FULL_CERT_CHAIN 作為 Flags 參數的值。
您的應用程式必須呼叫 RpcStringFree ,以釋放包含主體名稱的字串記憶體。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | rpcssl.h (包含 Rpc.h) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |