다음을 통해 공유

HttpSetServiceConfiguration 함수(http.h)

  • 아티클

HttpSetServiceConfiguration 함수는 HTTP Server API 구성 저장소에 대한 구성 레코드를 만들고 설정합니다. 지정된 레코드가 이미 있는 경우 호출이 실패합니다. 지정된 구성 레코드를 변경하려면 해당 레코드를 삭제한 다음 다른 값으로 다시 만듭니다.

구문

HTTPAPI_LINKAGE ULONG HttpSetServiceConfiguration(
  [in] HANDLE                 ServiceHandle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  pConfigInformation,
  [in] ULONG                  ConfigInformationLength,
  [in] LPOVERLAPPED           pOverlapped
);

매개 변수

[in] ServiceHandle

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

[in] ConfigId

설정할 구성 레코드의 유형입니다. 이 매개 변수는 HTTP_SERVICE_CONFIG_ID 열거형에서 다음 값 중 하나일 수 있습니다.

ConfigId 값 의미
HttpServiceConfigIPListenList
 IP 수신 대기 목록에 레코드를 설정합니다.
HttpServiceConfigSSLCertInfo
 지정된 SSL 인증서 레코드를 설정합니다.
HttpServiceConfigUrlAclInfo
 URL 예약 레코드를 설정합니다.
HttpServiceConfigTimeout
 지정된 HTTP Server API 전체 연결 제한 시간을 설정합니다.

Windows Vista 이상: 이 열거형 값이 지원됩니다.
HttpServiceConfigSslSniCertInfo
 지정된 SSL SNI(서버 이름 표시) 인증서 레코드를 설정합니다.

Windows 8 이상: 이 열거형 값이 지원됩니다.
HttpServiceConfigSslCcsCertInfo
 포트가 TLS(전송 계층 보안) 핸드셰이크를 수신하는 경우 인증서를 찾으려면 CCS(중앙 집중식 인증서 저장소) 저장소를 참조하도록 Http.sys 지정하는 SSL 인증서 레코드를 설정합니다. 포트는 pConfigInformation 매개 변수에 전달하는 HTTP_SERVICE_CONFIG_SSL_CCS_SET 구조체의 KeyDesc 멤버에 의해 지정됩니다.

Windows 8 이상: 이 열거형 값이 지원됩니다.

[in] pConfigInformation

설정할 레코드 유형을 지정하는 적절한 데이터가 포함된 버퍼에 대한 포인터입니다.

ConfigId 값 의미
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM 구조체입니다.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET 구조체입니다.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET 구조체입니다.
HttpServiceConfigTimeout

HTTP_SERVICE_CONFIG_TIMEOUT_SET 구조체입니다.

Windows Vista 이상: 이 구조는 지원됩니다.
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_SET 구조체입니다. SSL 중앙 인증서 저장소를 쿼리하고 와일드카드 바인딩을 사용하는 경우 호스트 이름은 "*"이고 일반 SNI의 호스트 이름은 "*"입니다.

Windows 8 이상: 이 구조가 지원됩니다.
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET 구조체입니다.

Windows 8 이상: 이 구조가 지원됩니다.

[in] ConfigInformationLength

pConfigInformation 버퍼의 크기(바이트)입니다.

[in] pOverlapped

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

반환 값

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

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

값 의미
ERROR_ALREADY_EXISTS
 지정된 레코드가 이미 있으며 값을 다시 설정하려면 삭제해야 합니다.
ERROR_INSUFFICIENT_BUFFER
 ConfigInformationLength 매개 변수에 지정된 버퍼 크기가 충분하지 않습니다.
ERROR_INVALID_HANDLE
 ServiceHandle 매개 변수가 잘못되었습니다.
ERROR_INVALID_PARAMETER
 제공된 매개 변수 중 하나 이상이 사용할 수 없는 형식입니다.
ERROR_NO_SUCH_LOGON_SESSION
 사용된 SSL 인증서가 잘못되었습니다. HttpServiceConfigSSLCertInfo 매개 변수를 사용하는 경우에만 발생할 수 있습니다.
기타
 WinError.h에 정의된 시스템 오류 코드 입니다.

설명

HttpSetServiceConfiguration으로 설정된 구성 매개 변수는 컴퓨터의 모든 HTTP 서버 API 애플리케이션에 적용되며 HTTP Server API가 종료되거나 컴퓨터가 다시 시작될 때 유지됩니다.

요구 사항

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

추가 정보

HTTP 서버 API 버전 1.0 함수

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration