ICertRequest3::GetIssuedCertificate2 メソッド (certcli.h)

  • [アーティクル]

GetIssuedCertificate2 メソッドは、要求 ID 文字列または証明書のシリアル番号を指定して、証明書の処理を取得します。

構文

HRESULT GetIssuedCertificate2(
  [in]          BSTR strConfig,
  [in]          BSTR strRequestId,
  [in]          BSTR strSerialNumber,
  [out, retval] LONG *pDisposition
);

パラメーター

[in] strConfig

Certificate Services サーバーの有効な構成文字列を表します。 文字列は、登録サーバーの HTTPS URL、または ComputerName\CAName 形式で指定できます。 ComputerName はサーバーのネットワーク名、 CAName は証明書サービスのセットアップ時に入力された 証明機関の共通名です。 構成文字列名の詳細については、「 ICertConfig」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: HTTPS URL は入力としてサポートされていません。

[in] strRequestId

Certificates Services データベース内の証明書要求 ID を表す BSTR 値。 要求 ID の代わりにシリアル番号 (strSerialNumber として渡される) を使用する場合は、このパラメーターを NULL に設定します。

ICertRequest3::GetRequestIdString メソッドを使用して、要求 ID 文字列を取得します。

[in] strSerialNumber

CA によって発行された証明書のシリアル番号を表す BSTR 値。 文字列では、シリアル番号を偶数の 16 進数として指定する必要があります。 必要に応じて、数字の前に 0 を付けて、偶数桁を生成できます。 ただし、先頭に 0 を 1 つ以上使用することはできません。

strSerialNumber 値は、strRequestId が NULL に設定されている場合にのみ使用されます。

[out, retval] pDisposition

証明書の処理を表す LONG 値へのポインター。 処理は、次のいずれかの値です。

値 意味
CR_DISP_DENIED
 要求が拒否されました。
CR_DISP_ERROR
 要求に失敗しました。
CR_DISP_INCOMPLETE
 要求が完了しませんでした。
CR_DISP_ISSUED
 発行された証明書。
CR_DISP_ISSUED_OUT_OF_BAND
 個別に発行された証明書。
CR_DISP_UNDER_SUBMISSION
 申請の下で行われた要求。

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返します。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

VB

戻り値は、証明書の処理を表す 長整数型 (Long) の値です。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー certcli.h (Certsrv.h を含む)
Library Certidl.lib
[DLL] Certcli.dll

こちらもご覧ください

CCertRequest

ICertRequest3