HttpDeleteServiceConfiguration 함수(http.h)

HttpDeleteServiceConfiguration 함수는 HTTP Server API 구성 저장소에서 IP 주소 또는 SSL 인증서와 같은 지정된 데이터를 한 번에 하나씩 삭제합니다.

구문

HTTPAPI_LINKAGE ULONG HttpDeleteServiceConfiguration(
  [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 수신 대기 목록에서 지정된 IP 주소를 삭제합니다.
HttpServiceConfigSSLCertInfo	지정된 SSL 인증서 레코드를 삭제합니다.
HttpServiceConfigUrlAclInfo	지정된 URL 예약 레코드를 삭제합니다.
HttpServiceConfigTimeout	지정된 연결 시간 제한을 삭제합니다. Windows Vista 이상: 이 열거형이 지원됩니다.
HttpServiceConfigSslSniCertInfo	지정된 SNI(SSL 서버 이름 표시) 인증서 레코드를 삭제합니다. Windows 8 이상: 이 열거형 값이 지원됩니다.
HttpServiceConfigSslCcsCertInfo	포트가 TLS(전송 계층 보안) 핸드셰이크를 수신하는 경우 인증서를 찾으려면 CCS(중앙 인증서 저장소) 저장소에 문의해야 Http.sys 지정하는 SSL 인증서 레코드를 삭제합니다. 포트는 pConfigInformation 매개 변수에 전달하는 HTTP_SERVICE_CONFIG_SSL_CCS_SET 구조체의 KeyDesc 멤버에 의해 지정됩니다. Windows 8 이상: 이 열거형 값이 지원됩니다.

[in] pConfigInformation

ConfigId 매개 변수에 지정된 구성 형식에 필요한 데이터가 포함된 버퍼에 대한 포인터입니다.

ConfigId 값	의미
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM 구조체입니다.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET 구조체입니다.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET 구조체입니다.
HttpServiceConfigTimeouts	HTTP_SERVICE_CONFIG_TIMEOUT_KEY 구조체입니다. 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_INVALID_PARAMETER	매개 변수 중 하나가 잘못되었습니다.
기타	WinError.h에 정의된 시스템 오류 코드 입니다.

요구 사항

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

참고 항목

HTTP Server API 버전 1.0 함수

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration