HttpCreateServerSession 함수(http.h)

  • 아티클

HttpCreateServerSession 함수는 지정된 버전에 대한 서버 세션을 만듭니다.

구문

HTTPAPI_LINKAGE ULONG HttpCreateServerSession(
  [in]  HTTPAPI_VERSION         Version,
  [out] PHTTP_SERVER_SESSION_ID ServerSessionId,
  [in]  ULONG                   Reserved
);

매개 변수

[in] Version

서버 세션의 버전을 나타내는 HTTPAPI_VERSION 구조체입니다. 버전 2.0의 경우 구조체의 instance 선언하고 httpCreateServerSession에 전달하기 전에 HTTPAPI_VERSION_2 미리 정의된 값으로 설정합니다.

버전은 2.0이어야 합니다. HttpCreateServerSession 은 버전 1.0 요청 큐를 지원하지 않습니다.

[out] ServerSessionId

서버 세션의 ID를 수신하는 변수에 대한 포인터입니다.

[in] Reserved

예약되어 있습니다. 0이어야 합니다.

반환 값

함수가 성공하면 NO_ERROR 반환합니다.

함수가 실패하면 다음 오류 코드 중 하나를 반환합니다.

값 의미
ERROR_REVISION_MISMATCH
 전달된 버전이 잘못되었거나 지원되지 않습니다.
ERROR_INVALID_PARAMETER
 pServerSessionId 매개 변수가 null이거나 Reserved가 0이 아닙니다.

설명

서버 세션은 URL 그룹 집합을 소유합니다. 이러한 컨테이너는 해당 컨테이너 아래에 생성된 모든 URL 그룹에 적용되는 구성 정보에 대한 최상위 구성 컨테이너입니다. 서버 세션 구성에 대한 자세한 내용은 HttpSetServerSessionProperty를 참조하세요.

HTTP 서버 API는 서버 세션에 대한 비동기 I/O를 지원하지 않습니다.

서버 세션이 더 이상 필요하지 않거나 애플리케이션이 종료되기 전에 애플리케이션은 HttpCloseServerSession을 호출하여 서버 세션을 삭제해야 합니다. 서버 세션이 삭제되면 연결된 모든 URL 그룹도 자동으로 삭제됩니다.

요구 사항

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

참고 항목

HTTP 서버 API 버전 2.0 함수

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty