共用方式為


CRYPT_RETRIEVE_AUX_INFO 結構 (wincrypt.h)

CRYPT_RETRIEVE_AUX_INFO 結構包含要傳遞至 CryptRetrieveObjectByUrl 函式的選擇性資訊。 這個結構的所有未使用成員都必須包含零。

語法

typedef struct _CRYPT_RETRIEVE_AUX_INFO {
  DWORD                              cbSize;
  FILETIME                           *pLastSyncTime;
  DWORD                              dwMaxUrlRetrievalByteCount;
  PCRYPTNET_URL_CACHE_PRE_FETCH_INFO pPreFetchInfo;
  PCRYPTNET_URL_CACHE_FLUSH_INFO     pFlushInfo;
  PCRYPTNET_URL_CACHE_RESPONSE_INFO  *ppResponseInfo;
  LPWSTR                             pwszCacheFileNamePrefix;
  LPFILETIME                         pftCacheResync;
  BOOL                               fProxyCacheRetrieval;
  DWORD                              dwHttpStatusCode;
  LPWSTR                             *ppwszErrorResponseHeaders;
  PCRYPT_DATA_BLOB                   *ppErrorContentBlob;
} CRYPT_RETRIEVE_AUX_INFO, *PCRYPT_RETRIEVE_AUX_INFO;

成員

cbSize

以位元組為單位的結構大小。

pLastSyncTime

FILETIME 結構,包含上次擷取之數據同步處理的時間。

dwMaxUrlRetrievalByteCount

值,指定所擷取位元組數目的限制。 值為零或更少指定沒有限制。

pPreFetchInfo

CRYPTNET_URL_CACHE_PRE_FETCH_INFO 結構的指標。 若要取得預先擷取資訊,請在輸入時設定其 cbSize 。 對於沒有預先擷取資訊,除了 cbSize 之外,數據結構會在傳回時包含零。

pFlushInfo

CRYPTNET_URL_CACHE_FLUSH_INFO 結構的指標。 若要取得排清資訊,請在輸入時設定其 cbSize 。 對於沒有排清資訊,除了 cbSize 之外,數據結構會在傳回時包含零。

ppResponseInfo

PCRYPTNET_URL_CACHE_RESPONSE_INFO 結構的指標。 若要取得響應資訊,請將指標設定為已配置結構更新 之CRYPTNET_URL_CACHE_RESPONSE_INFO 指標的位址。 對於沒有回應資訊, ppResponseInfo 會設定為 NULL。 如果不是 NULL,則必須使用 CryptMemFree 函式釋放它。

pwszCacheFileNamePrefix

字串的指標,其中包含快取檔名的前置詞。 如果不是 NULL,則指定的前置詞字串會串連至快取檔名的前面。

pftCacheResync

指定快取同步處理時間之 FILETIME 結構的指標。 如果不是 NULL,則會將這段時間之前快取的任何資訊視為無效的時間。 對於 CRYPT_CACHE_ONLY_RETRIEVAL,如果目前之前有快取的專案, CryptRetrieveObjectByUrl 會傳回 ERROR_INVALID_TIME。 搭配 HTTP 擷取使用時,這會指定有效時間物件的最大存留期。

fProxyCacheRetrieval

值,指出在 dwRetrievalFlags 中設定CRYPT_PROXY_CACHE_RETRIEVAL呼叫 CryptRetrieveObjectByUrl,而且未明確略過 Proxy 快取以進行擷取。 此旗標未明確清除,且僅適用於 HTTP URL 擷取。

dwHttpStatusCode

值,指定來自不成功 HTTP 回應標頭的狀態代碼。 如果 已在dwRetrievalFlags 中設定CRYPT_NOT_MODIFIED_RETRIEVAL,而 HTTP 擷取會傳回 HTTP_STATUS_NOT_MODIFIED,則其中包含 HTTP_STATUS_NOT_MODIFIED 狀態代碼。 此值不會明確清除,而且只會針對 HTTP 或 HTTPS URL 擷取進行更新。

ppwszErrorResponseHeaders

ppErrorContentBlob

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 wincrypt.h