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

関連項目

プリンシパル名

RpcStringFree