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 값 | 의미 |
|---|---|
|
IP 수신 대기 목록에 레코드를 설정합니다. |
|
지정된 SSL 인증서 레코드를 설정합니다. |
|
URL 예약 레코드를 설정합니다. |
|
지정된 HTTP Server API 전체 연결 제한 시간을 설정합니다. Windows Vista 이상: 이 열거형 값이 지원됩니다. |
|
지정된 SSL SNI(서버 이름 표시) 인증서 레코드를 설정합니다.
Windows 8 이상: 이 열거형 값이 지원됩니다. |
|
포트가 TLS(전송 계층 보안) 핸드셰이크를 수신하는 경우 인증서를 찾으려면 CCS(중앙 집중식 인증서 저장소) 저장소를 참조하도록 Http.sys 지정하는 SSL 인증서 레코드를 설정합니다. 포트는 pConfigInformation 매개 변수에 전달하는 HTTP_SERVICE_CONFIG_SSL_CCS_SET 구조체의 KeyDesc 멤버에 의해 지정됩니다.
Windows 8 이상: 이 열거형 값이 지원됩니다. |
[in] pConfigInformation
설정할 레코드 유형을 지정하는 적절한 데이터가 포함된 버퍼에 대한 포인터입니다.
| ConfigId 값 | 의미 |
|---|---|
|
|
|
HTTP_SERVICE_CONFIG_SSL_SET 구조체입니다. |
|
HTTP_SERVICE_CONFIG_URLACL_SET 구조체입니다. |
|
HTTP_SERVICE_CONFIG_TIMEOUT_SET 구조체입니다. Windows Vista 이상: 이 구조는 지원됩니다. |
|
HTTP_SERVICE_CONFIG_SSL_SNI_SET 구조체입니다. SSL 중앙 인증서 저장소를 쿼리하고 와일드카드 바인딩을 사용하는 경우 호스트 이름은 "*"이고 일반 SNI의 호스트 이름은 "*"입니다. Windows 8 이상: 이 구조가 지원됩니다. |
|
HTTP_SERVICE_CONFIG_SSL_CCS_SET 구조체입니다. Windows 8 이상: 이 구조가 지원됩니다. |
[in] ConfigInformationLength
pConfigInformation 버퍼의 크기(바이트)입니다.
[in] pOverlapped
이 매개 변수는 예약되어 있으며 NULL이어야 합니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 값 | 의미 |
|---|---|
|
지정된 레코드가 이미 있으며 값을 다시 설정하려면 삭제해야 합니다. |
|
ConfigInformationLength 매개 변수에 지정된 버퍼 크기가 충분하지 않습니다. |
|
ServiceHandle 매개 변수가 잘못되었습니다. |
|
제공된 매개 변수 중 하나 이상이 사용할 수 없는 형식입니다. |
|
사용된 SSL 인증서가 잘못되었습니다. HttpServiceConfigSSLCertInfo 매개 변수를 사용하는 경우에만 발생할 수 있습니다. |
|
WinError.h에 정의된 시스템 오류 코드 입니다. |
설명
HttpSetServiceConfiguration으로 설정된 구성 매개 변수는 컴퓨터의 모든 HTTP 서버 API 애플리케이션에 적용되며 HTTP Server API가 종료되거나 컴퓨터가 다시 시작될 때 유지됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | http.h |
| 라이브러리 | Httpapi.lib |
| DLL | Httpapi.dll |