Поделиться через

структура 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

Значение , указывающее, был ли вызван CryptRetrieveObjectByUrl с CRYPT_PROXY_CACHE_RETRIEVAL , заданным в dwRetrievalFlags , и кэш прокси-сервера не был явно обходить для извлечения. Этот флаг не очищается явным образом и применяется только к получению URL-адресов HTTP.

dwHttpStatusCode

Значение типа , указывающее код состояния из заголовка неудачного HTTP-ответа. Если CRYPT_NOT_MODIFIED_RETRIEVAL задано в dwRetrievalFlags, а получение HTTP возвращает HTTP_STATUS_NOT_MODIFIED, он содержит код состояния HTTP_STATUS_NOT_MODIFIED . Это значение не очищается явным образом и обновляется только для получения URL-адресов HTTP или HTTPS.

ppwszErrorResponseHeaders

ppErrorContentBlob

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть wincrypt.h