HttpUpdateServiceConfiguration 함수(http.h)

아티클
08/24/2023

업데이트 HTTP Server API 구성 저장소 내의 구성 레코드에서 TLS(전송 계층 보안) 인증서를 지정하는 서비스 구성 매개 변수입니다.

구문

HTTPAPI_LINKAGE ULONG HttpUpdateServiceConfiguration(
  [in] HANDLE                 Handle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  ConfigInfo,
  [in] ULONG                  ConfigInfoLength,
  [in] LPOVERLAPPED           Overlapped
);

매개 변수

[in] Handle

예약된 및 는 NULL이어야 합니다.

[in] ConfigId

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

ConfigId 값	의미
HttpServiceConfigSSLCertInfo	지정된 SSL 인증서 레코드를 업데이트.
HttpServiceConfigSslSniCertInfo	지정된 SSL SNI(서버 이름 표시) 인증서 레코드를 업데이트.
HttpServiceConfigSslCcsCertInfo	포트가 TLS 핸드셰이크를 수신하는 경우 인증서를 찾으려면 Http.sys CCS(중앙 집중식 인증서 저장소) 저장소를 참조하도록 지정하는 SSL 인증서 레코드를 업데이트. 포트는 pConfigInfo 매개 변수에 전달하는 HTTP_SERVICE_CONFIG_SSL_CCS_SET 구조체의 KeyDesc 멤버에 의해 지정됩니다.

[in] ConfigInfo

업데이트할 레코드 유형을 지정하기 위한 적절한 데이터가 포함된 버퍼에 대한 포인터입니다. 다음 표에서는 ConfigId 매개 변수의 다양한 가능한 값에 대해 버퍼에 포함된 데이터 형식을 보여 줍니다.

ConfigId 값	pConfigInfo 버퍼의 데이터 형식
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET 구조체입니다.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET 구조체입니다. SSL 중앙 인증서 저장소를 쿼리하고 와일드카드 바인딩을 사용하는 경우 호스트 이름은 ""이고 일반 SNI의 호스트 이름은 ""입니다.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_SET 구조체입니다. 이 구조체는 지정된 포트에 CCS 저장소를 추가하고 기존 SSL CCS 레코드를 삭제, 검색 또는 업데이트하는 데 사용됩니다.

[in] ConfigInfoLength

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

[in] Overlapped

예약된 및 는 NULL이어야 합니다.

반환 값

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

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

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

설명

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

요구 사항

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