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

  • [アーティクル]

GetFullResponseProperty メソッドは、サーバーから返されたキャッシュされた応答データを取得します。

構文

HRESULT GetFullResponseProperty(
  [in]  LONG    PropId,
  [in]  LONG    PropIndex,
  [in]  LONG    PropType,
  [in]  LONG    Flags,
  [out] VARIANT *pvarPropertyValue
);

パラメーター

[in] PropId

取得するデータ。 プロパティにインデックスが付いている場合は、 PropIndex を使用してインデックスを指定します。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
FR_PROP_NONE
0
 データがありません。
FR_PROP_FULLRESPONSE
1
 キャッシュされたすべてのデータが取得されます (バイナリ データ)。
FR_PROP_STATUSINFOCOUNT
2
 キャッシュ データ内の応答の数 (long、インデックス付きプロパティ)。
FR_PROP_BODYPARTSTRING
3
 階層データ (文字列、インデックス付きプロパティ)。
FR_PROP_STATUS
4
 要求の状態の値 (長い、インデックス付きプロパティ)。
FR_PROP_STATUSSTRING
5
 要求の状態文字列 (文字列、インデックス付きプロパティ)。
FR_PROP_OTHERINFOCHOICE
6
 その他の情報 (長いインデックス付きプロパティ) を選択します。 次のいずれかの値を指定できます。
  • CMC_OTHER_INFO_NO_CHOICE
  • CMC_OTHER_INFO_FAIL_CHOICE
  • CMC_OTHER_INFO_PEND_CHOICE
FR_PROP_FAILINFO
7
 要求エラー情報 (長いインデックス付きプロパティ)。
FR_PROP_PENDINFOTOKEN
8
 要求保留中のトークン (バイナリ、インデックス付きプロパティ)。
FR_PROP_PENDINFOTIME
9
 要求の保留中の日付 (DATE、インデックス付きプロパティ)。
FR_PROP_ISSUEDCERTIFICATEHASH
10
 発行された証明書のハッシュが取得されます (バイナリ、インデックス付きプロパティ)。
FR_PROP_ISSUEDCERTIFICATE
11
 発行された証明書が取得されます (バイナリ、インデックス付きプロパティ)。
FR_PROP_ISSUEDCERTIFICATECHAIN
12
 発行された証明書 (バイナリ、インデックス付きプロパティ)。
FR_PROP_ISSUEDCERTIFICATECRLCHAIN
13
 発行された証明書チェーン (バイナリ、インデックス付きプロパティ)。
FR_PROP_ENCRYPTEDKEYHASH
14
 暗号化されたキー ハッシュ (バイナリ、インデックス付きプロパティ)。
FR_PROP_FULLRESPONSENOPKCS7
15
 PKCS #7 (バイナリ) を除き、キャッシュされたすべてのデータが取得されます。
FR_PROP_CAEXCHANGECERTIFICATEHASH
16
 CA 交換証明書ハッシュ。
FR_PROP_CAEXCHANGECERTIFICATE
17
 CA 交換証明書。
FR_PROP_CAEXCHANGECERTIFICATECHAIN
18
 CA 交換証明書チェーン。
FR_PROP_CAEXCHANGECERTIFICATECRLCHAIN
19
 CA 交換証明書 CLR チェーン。
FR_PROP_ATTESTATIONCHALLENGE
20
 主要な構成証明チャレンジ応答
FR_PROP_ATTESTATIONPROVIDERNAME
21
 キー構成証明のキー ストレージ プロバイダーの名前。

[in] PropIndex

PropId がインデックス付きプロパティの場合の 0 から始まるインデックス。 PropId がインデックス付きプロパティでない場合、PropIndex は 0 である必要があります。

[in] PropType

pvarPropertyValue で返されるデータの型。 ここでのプロパティ型は 、PropId パラメーターで指定されたデータの型と一致する必要があります。

このパラメーターには、次の値のいずれかを指定できます。

値 意味
PROPTYPE_LONG
1
 署名された長いデータ。
PROPTYPE_DATE
2
 日付データ (日付と時刻を含む)。
PROPTYPE_BINARY
3
 バイナリ データ。
PROPTYPE_STRING
4
 文字列データ。

[in] Flags

pvarPropertyValue で返されるデータの形式。 ここで設定するフラグは 、PropId パラメーターで指定されたデータの型と一致する必要があります。

詳細については、「解説」を参照してください。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
CR_OUT_BASE64HEADER
0
 開始/終了ヘッダーを含む BASE64 形式。
CR_OUT_BASE64
1
 先頭/末尾ヘッダーのない BASE64 形式。
CR_OUT_BINARY
2
 バイナリ形式。

[out] pvarPropertyValue

返されるデータ。

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返し、 pvarPropertyValue には返されたデータが含まれます。

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

VB

戻り値は、返されたデータを含む バリアント型 (Variant) の 値です。

注釈

次の PropId 値はバイナリ データを返します。つまり、 Flags パラメーターを CR_OUT_BINARY に設定する必要があります。

  • FR_PROP_FULLRESPONSE
  • FR_PROP_ISSUEDCERTIFICATEHASH
  • FR_PROP_ISSUEDCERTIFICATE
  • FR_PROP_ISSUEDCERTIFICATECHAIN
  • FR_PROP_ISSUEDCERTIFICATECRLCHAIN
  • FR_PROP_ENCRYPTEDKYEHASH
  • FR_PROP_FULLRESPONSENOPKCS7
このメソッドは、 ICertRequest3::Submit メソッドまたは ICertRequest3::RetrievePending メソッドが呼び出された後に呼び出されます。 これらのメソッドは、 GetFullResponseProperty によって返されるキャッシュされたデータを設定します。

ICertRequest3::GetFullResponseProperty メソッドがデータを返した後、次のメソッドを呼び出すことができます。

要件

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