ICertRequest2::GetIssuedCertificate メソッド (certcli.h)

  • [アーティクル]

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

このメソッドは、 ICertRequest3::RetrievePending を呼び出すのと実質的に同じです。また、問題の証明書のシリアル番号を指定する追加機能があります。

構文

HRESULT GetIssuedCertificate(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [in]          const 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] RequestId

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

[in] strSerialNumber

CA によって発行された証明書のシリアル番号を表す BSTR 値。 strSerialNumber を使用するには、RequestId に –1 の値を指定する必要があります。

[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 XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー certcli.h (Certsrv.h を含む)
Library Certidl.lib
[DLL] Certcli.dll