CryptGetTimeValidObject 函式 (wincrypt.h)

CryptGetTimeValidObject 函式會擷取在指定內容和時間內有效的 CRL、OCSP 回應或 CTL 物件。

語法

BOOL CryptGetTimeValidObject(
  [in]                LPCSTR                                  pszTimeValidOid,
  [in]                LPVOID                                  pvPara,
  [in]                PCCERT_CONTEXT                          pIssuer,
  [in, optional]      LPFILETIME                              pftValidFor,
  [in]                DWORD                                   dwFlags,
  [in]                DWORD                                   dwTimeout,
  [out, optional]     LPVOID                                  *ppvObject,
  [in, optional]      PCRYPT_CREDENTIALS                      pCredentials,
  [in, out, optional] PCRYPT_GET_TIME_VALID_OBJECT_EXTRA_INFO pExtraInfo
);

參數

[in] pszTimeValidOid

識別所要求 對象的物件標識碼 指標 (OID) 。 如果 pszTimeValidOid 參數的 HIWORD 為零，LOWORD 會指定指定結構類型的整數識別碼。

此參數可以是下列其中一個值。 如需這些值如何影響 pvPara 參數的資訊，請參閱 [意義] 資料行中的標題“For the pvPara parameter”。

[in] pvPara

由 pszTimeValidOid 值決定的結構。 如需詳細資訊，請參閱 pszTimeValidOid 參數的描述。

[in] pIssuer

包含簽發者憑證 之CERT_CONTEXT 的指標。

[in, optional] pftValidFor

目前系統時間選擇性 FILETIME 結構版本的指標，或目前內容的全新時間。

[in] dwFlags

值，決定各種擷取因素，例如逾時、來源和有效性檢查。

下表列出 dwFlags 參數的可能值。

[in] dwTimeout

值，以毫秒為單位，指定何時終止未傳回結果的 URL 擷取嘗試。

[out, optional] ppvObject

所傳回物件的位址指標。 傳回型別可以是 CryptRetrieveObjectByUrl 函式之 pszObjectOid 參數中顯示的其中一種支援型別。

[in, optional] pCredentials

用來存取 URL 之選擇性 CRYPT_CREDENTIALS 結構的指標。 目前唯一支持的認證類型是使用者名稱和密碼認證。

[in, out, optional] pExtraInfo

選擇性 CRYPT_GET_TIME_VALID_OBJECT_EXTRA_INFO 結構的指標，其中包含物件快取專案的額外資訊。

傳回值

如果函式成功，函式會傳回 TRUE。

如果函式失敗，則會傳回 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。

以下是一些可能的錯誤碼。

備註

Cryptnet 動態連結庫會實作時間有效的物件 (TVO) 快取，用來支援 CryptGetTimeValidObject 函式。 快取是由進程全域 TVO 代理程式使用，其中每個快取專案都包含下列資訊。

• 原始標識碼
• 內容 OID
• Context
• 擷取
• 到期時間
• 離線 URL 時間資訊

規格需求