RpcCertGeneratePrincipalName 関数 (rpcssl.h)
サーバー プログラムでは、 RpcCertGeneratePrincipalName 関数を使用して、セキュリティ証明書の プリンシパル名 を生成します。
構文
RPC_STATUS RpcCertGeneratePrincipalName(
PCCERT_CONTEXT Context,
DWORD Flags,
RPC_CSTR *pBuffer
);
パラメーター
Context
セキュリティ証明書コンテキストへのポインター。
Flags
現在、このパラメーターの有効なフラグはRPC_C_FULL_CERT_CHAINのみです。 このフラグを使用すると、プリンシパル名が完全形式で生成されます。
pBuffer
ポインターへのポインター。 RpcCertGeneratePrincipalName 関数は、プリンシパル名を含む null で終わる文字列を指すよう設定します。
戻り値
この関数は値を返しません。
注釈
既定では、 RpcCertGeneratePrincipalName 関数が返すプリンシパル名は msstd 形式です。 完全形式で名前を生成するには、 flags パラメーターの値として RPC_C_FULL_CERT_CHAINを渡します。
アプリケーションで RpcStringFree を 呼び出して、プリンシパル名を含む文字列のメモリを解放する必要があります。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | rpcssl.h (Rpc.h を含む) |
| Library | Rpcrt4.lib |
| [DLL] | Rpcrt4.dll |