共用方式為

RpcCertGeneratePrincipalNameW 函式 （rpcssl.h）

  • 發行項

伺服器程式會使用 RpcCertGeneratePrincipalName 函式來產生安全性憑證 主體名稱。

語法

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

參數

Context

安全性憑證內容的指標。

Flags

目前，此參數的唯一有效旗標是RPC_C_FULL_CERT_CHAIN。 使用此旗標會導致主體名稱以完整格式產生。

pBuffer

指標。 RpcCertGeneratePrincipalName 函式會將此設定為指向包含 主體名稱的 null 終止字串。

傳回值

此函式不會傳回值。

言論

根據預設，RpcCertGeneratePrincipalName 函式傳回的主體名稱是 msstd 格式。 若要以完整格式產生名稱，請傳遞 RPC_C_FULL_CERT_CHAIN 做為 Flags 參數的值。

您的應用程式必須呼叫 RpcStringFree，以釋放包含主體名稱的字串記憶體。

注意

rpcssl.h 標頭會根據 UNICODE 預處理器常數的定義，將 RpcCertGeneratePrincipalName 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 rpcssl.h （包括 Rpc.h）
連結庫 Rpcrt4.lib
DLL Rpcrt4.dll

另請參閱

主體名稱

RpcStringFree