IX509Enrollment::Enroll メソッド (certenroll.h)
Enroll メソッドは要求をエンコードし、適切な証明機関 (CA) に送信し、応答をインストールします。
構文
HRESULT Enroll();
戻り値
関数が成功した場合、関数は S_OKを返します。
関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。
リターン コード/値 | Description |
---|---|
|
登録オブジェクトが初期化されていません。 |
注釈
メソッドは、必要に応じてキー ペアを作成できます。 登録オブジェクトを初期化する方法と設定したプロパティによっては、キー ペアを作成する必要がない場合があります。 たとえば、既存のキーを使用して証明書を更新する場合、または証明書要求に関連付けられている IX509PrivateKey オブジェクトが既存のキーを表している場合、このメソッドは新しいキー ペアを作成しません。
登録する前に、次のいずれかのメソッドを呼び出して IX509Enrollment オブジェクトを初期化する必要があります。
登録操作が成功した場合、関数は S_OKを返します。 ただし、これは必ずしも CA からの応答がインストールされたことを意味するとは限りません。 Status プロパティを呼び出して、登録の状態を確認します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | certenroll.h |
[DLL] | CertEnroll.dll |