次の方法で共有


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