다음을 통해 공유

HttpInitialize 함수(http.h)

  • 아티클

HttpInitialize 함수는 HTTP Server API 드라이버를 초기화하고, 아직 시작하지 않은 경우 시작하며, 응답 큐 만들기 및 기타 작업을 지원하기 위해 호출 애플리케이션에 대한 데이터 구조를 할당합니다. HTTP Server API에서 다른 함수를 호출하기 전에 이 함수를 호출합니다.

구문

HTTPAPI_LINKAGE ULONG HttpInitialize(
  [in]      HTTPAPI_VERSION Version,
  [in]      ULONG           Flags,
  [in, out] PVOID           pReserved
);

매개 변수

[in] Version

HTTP 버전입니다. 이 매개 변수는 HTTPAPI_VERSION 구조체입니다. 현재 버전의 경우 구조체의 instance 선언하고 httpInitialize에 전달하기 전에 HTTPAPI_VERSION_1 미리 정의된 값으로 설정합니다.

[in] Flags

다음 값 중 하나 또는 둘 다를 포함할 수 있는 초기화 옵션입니다.

값 의미
HTTP_INITIALIZE_CONFIG
 HTTP 구성 함수, HttpSetServiceConfiguration, HttpQueryServiceConfiguration, HttpDeleteServiceConfiguration 및 HttpIsFeatureSupported를 사용하는 애플리케이션에 대해 초기화를 수행합니다.
HTTP_INITIALIZE_SERVER
 HTTP Server API를 사용하는 애플리케이션에 대한 초기화를 수행합니다.

[in, out] pReserved

이 매개 변수는 예약되어 있으며 NULL이어야 합니다.

반환 값

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

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

값 의미
ERROR_INVALID_PARAMETER
 Flags 매개 변수에는 지원되지 않는 값이 포함됩니다.
기타
 WinError.h에 정의된 시스템 오류 코드 입니다.

설명

애플리케이션 이 완료되면 HttpTerminate 를 호출합니다. Flags 매개 변수에서 HttpInitialize 에 전달된 모든 동일한 플래그 도 HttpTerminate에 전달되어야 합니다. HttpInitialize에 대한 각 호출이 나중에 HttpTerminate에 대한 해당 호출과 일치하면 애플리케이션에서 HttpInitialize를 반복적으로 호출할 수 있습니다.

요구 사항

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

추가 정보