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