HttpFlushResponseCache 함수(http.h)

아티클
08/24/2023

HttpFlushResponseCache 함수는 지정된 요청 큐와 연결된 HTTP Server API 캐시에서 사이트 부분이 지정된 UrlPrefix와 일치하는 이름을 가진 모든 응답 조각을 제거합니다. 애플리케이션은 이전에 HttpAddUrl 또는 HttpAddUrlToUrlGroup 을 호출하여 이 UrlPrefix 또는 유효한 접두사를 해당 요청 큐에 추가한 다음 HttpAddFragmentToCache 를 호출하여 연결된 응답 조각 또는 조각을 캐시해야 합니다.

구문

HTTPAPI_LINKAGE ULONG HttpFlushResponseCache(
  [in] HANDLE       RequestQueueHandle,
  [in] PCWSTR       UrlPrefix,
  [in] ULONG        Flags,
  [in] LPOVERLAPPED Overlapped
);

매개 변수

[in] RequestQueueHandle

이 캐시가 연결된 요청 큐에 대한 핸들입니다. 요청 큐가 생성되고 HttpCreateRequestQueue 함수에 대한 호출에서 해당 핸들이 반환됩니다.

Windows Server 2003 SP1 및 Windows XP SP2 사용: 요청 큐에 대한 핸들은 HttpCreateHttpHandle 함수에 의해 만들어집니다.

[in] UrlPrefix

조각 이름의 사이트 부분과 일치하는 UrlPrefix 문자열 에 대한 포인터입니다. 애플리케이션은 이전에 HttpAddUrl 을 호출하여 이 UrlPrefix 또는 해당 Url의 유효한 접두사를 해당 요청 큐에 추가한 다음 HttpAddFragmentToCache 를 호출하여 연결된 응답 조각을 캐시해야 합니다.

[in] Flags

이 매개 변수에는 다음 플래그가 포함될 수 있습니다.

HTTP_FLUSH_RESPONSE_FLAG_RECURSIVE

사이트 부분이 지정된 UrlPrefix의 계층적 하위 항목인 이름이 있는 응답 조각이 조각 캐시에서 제거되고 사이트 부분이 직접 일치하는 조각도 제거되도록 합니다.

[in] Overlapped

비동기 호출의 경우 pOverlapped 를 OVERLAPPED 구조를 가리키도록 설정하거나 동기 호출의 경우 NULL로 설정합니다.

동기 호출은 캐시 작업이 완료될 때까지 차단되는 반면, 비동기 호출은 즉시 ERROR_IO_PENDING 반환하고 호출 애플리케이션은 GetOverlappedResult 또는 I/O 완료 포트를 사용하여 작업이 완료되는 시기를 결정합니다. 동기화에 OVERLAPPED 구조를 사용하는 방법에 대한 자세한 내용은 동기화 및 겹치는 입력 및 출력을 참조하세요.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

함수를 비동기적으로 사용하는 경우 ERROR_IO_PENDING 반환 값은 캐시 요청이 큐에 대기되고 나중에 일반 겹치는 I/O 완료 메커니즘을 통해 완료됨을 나타냅니다.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

값	의미
ERROR_INVALID_PARAMETER	매개 변수 중 하나가 잘못되었습니다.
기타	WinError.h에 정의된 시스템 오류 코드 입니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	http.h
라이브러리	Httpapi.lib
DLL	Httpapi.dll

참고 항목

HTTP 서버 API 버전 1.0 함수

HttpAddFragmentToCache

HttpReadFragmentFromCache

다음을 통해 공유