HttpCreateHttpHandle 함수(http.h)

HttpCreateHttpHandle 함수는 호출하는 애플리케이션에 대한 HTTP 요청 큐를 만들고 핸들을 반환합니다.

HTTP Server API 버전 2.0부터 애플리케이션은 HttpCreateRequestQueue 를 호출하여 요청 큐를 만들어야 합니다. HttpCreateHttpHandle을 사용하면 안 됩니다.

구문

HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
  [out] PHANDLE RequestQueueHandle,
  [in]  ULONG   Reserved
);

[out] RequestQueueHandle

요청 큐에 대한 핸들을 수신하는 변수에 대한 포인터입니다.

[in] Reserved

예약되어 있습니다. 이 매개 변수는 0이어야 합니다.

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

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

값	의미
ERROR_DLL_INIT_FAILED	호출하는 애플리케이션은 이 함수를 호출하기 전에 HttpInitialize를 호출하지 않았습니다.
기타	WinError.h에 정의된 시스템 오류 코드 입니다.

요청 큐를 사용하면 호출 애플리케이션이 특정 URL에 대한 요청을 수신할 수 있습니다. 호출 애플리케이션은 HttpAddUrl 함수를 사용하여 요청을 받을 URL을 지정합니다.

애플리케이션은 단일 요청 큐를 사용하여 요청을 수신해야 합니다. 단일 프로세스에서 여러 요청 큐를 사용하면 응답 시간 또는 처리량이 증가하지 않습니다.

애플리케이션이 요청 수신을 완료하면 CloseHandle 함수를 호출하여 핸들을 닫아야 합니다.


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