IX509Enrollment::CreateRequest メソッド (certenroll.h)

  • [アーティクル]

CreateRequest メソッドは、エンコードされた証明書要求を取得します。 証明書要求は、抽象構文表記 1 (ASN.1) 標準で定義されているDistinguished Encoding Rules (DER) を使用してエンコードされたバイト配列に含まれています。 DER でエンコードされたバイト配列は、純粋なバイナリ シーケンスまたは Unicode エンコードされた文字列で表されます。 このメソッドは Web 対応です。

構文

HRESULT CreateRequest(
  [in]  EncodingType Encoding,
  [out] BSTR         *pValue
);

パラメーター

[in] Encoding

DER でエンコードされた要求に適用される Unicode エンコードの種類を指定する EncodingType 列挙値。 既定値は XCN_CRYPT_STRING_BASE64です。

[out] pValue

DER でエンコードされた要求を含む BSTR 変数へのポインター。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

リターン コード/値 Description
CERTSRV_E_PROPERTY_EMPTY
 証明書要求が見つかりません。
OLE_E_BLANK
 登録オブジェクトが初期化されていません。

注釈

CreateRequest メソッドは、必要に応じて Encode メソッドを呼び出して、関連付けられた要求オブジェクトから生データをエンコードします。

このメソッドは、初期化中に提供された情報と、指定されたその他のプロパティを使用して、ダミー証明書を作成し、要求ストアに配置します。 メソッドは、必要に応じてキー ペアも作成します。 登録オブジェクトを初期化する方法と設定したプロパティによっては、キー ペアを作成する必要がない場合があります。 たとえば、既存のキーを使用して証明書を更新する場合、または証明書要求に関連付けられている IX509PrivateKey オブジェクトが既存のキーを表している場合、このメソッドは新しいキー ペアを作成しません。

スマートカードが関係する場合、このメソッドは外部プロパティを拡張機能としてエンコードし、ダミー証明書に含め、ダミー証明書をスマートカード キー コンテナーに書き込みます。 スマートカード ログオン証明書は、個人用ストアではなく、要求ストアにエンコードされます。

CreateRequest メソッドを呼び出す前に、次のいずれかのメソッドを呼び出して IX509Enrollment オブジェクトを初期化する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー certenroll.h
[DLL] CertEnroll.dll

こちらもご覧ください

IX509CertificateRequest

IX509Enrollment