CRYPT_RETRIEVE_AUX_INFO 구조체(wincrypt.h)

CRYPT_RETRIEVE_AUX_INFO 구조체에는 CryptRetrieveObjectByUrl 함수에 전달할 선택적 정보가 포함되어 있습니다. 이 구조체의 사용되지 않는 모든 멤버는 0을 포함해야 합니다.

구문

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

검색된 바이트 수에 대한 제한을 지정하는 값입니다. 0 이하의 값은 제한을 지정하지 않습니다.

pPreFetchInfo

CRYPTNET_URL_CACHE_PRE_FETCH_INFO 구조체에 대한 포인터입니다. 프리페치 정보를 얻으려면 입력 시 cbSize 를 설정합니다. cbSize를 제외한 프리페치 정보가 없으면 데이터 구조에 반환 시 0이 포함됩니다.

pFlushInfo

CRYPTNET_URL_CACHE_FLUSH_INFO 구조체에 대한 포인터입니다. 플러시 정보를 얻으려면 입력 시 cbSize 를 설정합니다. cbSize를 제외하고 플러시 정보가 없으면 데이터 구조에 반환 시 0이 포함됩니다.

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이 dwRetrievalFlags에서 설정된 CRYPT_PROXY_CACHE_RETRIEVAL 호출되었고 프록시 캐시가 검색을 위해 명시적으로 바이패스되지 않은지 여부를 나타내는 값입니다. 이 플래그는 명시적으로 지워지지 않으며 HTTP URL 검색에만 적용됩니다.

dwHttpStatusCode

실패한 HTTP 응답 헤더의 상태 코드를 지정하는 값입니다. CRYPT_NOT_MODIFIED_RETRIEVALdwRetrievalFlags에서 설정되었고 HTTP 검색이 HTTP_STATUS_NOT_MODIFIED 반환하는 경우 HTTP_STATUS_NOT_MODIFIED 상태 코드가 포함됩니다. 이 값은 명시적으로 지워지지 않으며 HTTP 또는 HTTPS URL 검색에 대해서만 업데이트됩니다.

ppwszErrorResponseHeaders

ppErrorContentBlob

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	wincrypt.h