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
 快取數據中的回應數目 (長、索引屬性) 。
FR_PROP_BODYPARTSTRING
3
 階層資料 (字串、索引屬性) 。
FR_PROP_STATUS
4
 要求狀態值 (long、indexed 屬性) 。
FR_PROP_STATUSSTRING
5
 要求狀態字串 (字串、索引屬性) 。
FR_PROP_OTHERINFOCHOICE
6
 (long、indexed 屬性) 的其他信息選擇。 這可以是下列其中一個值。
  • 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 是索引屬性時，以零起始的索引。 如果 PropId 不是索引屬性， 則 PropIndex 必須是零。

[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)
程式庫 Certidl.lib
Dll Certcli.dll