通过

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，并且未显式绕过代理缓存进行检索。 此标志未显式清除，仅适用于 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