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 값 | 의미 |
|---|---|
|
IP 수신 대기 목록에서 지정된 IP 주소를 삭제합니다. |
|
지정된 SSL 인증서 레코드를 삭제합니다. |
|
지정된 URL 예약 레코드를 삭제합니다. |
|
지정된 연결 시간 제한을 삭제합니다.
Windows Vista 이상: 이 열거형이 지원됩니다. |
|
지정된 SNI(SSL 서버 이름 표시) 인증서 레코드를 삭제합니다.
Windows 8 이상: 이 열거형 값이 지원됩니다. |
|
포트가 TLS(전송 계층 보안) 핸드셰이크를 수신하는 경우 인증서를 찾으려면 CCS(중앙 인증서 저장소) 저장소에 문의해야 Http.sys 지정하는 SSL 인증서 레코드를 삭제합니다. 포트는 pConfigInformation 매개 변수에 전달하는 HTTP_SERVICE_CONFIG_SSL_CCS_SET 구조체의 KeyDesc 멤버에 의해 지정됩니다.
Windows 8 이상: 이 열거형 값이 지원됩니다. |
[in] pConfigInformation
ConfigId 매개 변수에 지정된 구성 형식에 필요한 데이터가 포함된 버퍼에 대한 포인터입니다.
| ConfigId 값 | 의미 |
|---|---|
|
|
|
HTTP_SERVICE_CONFIG_SSL_SET 구조체입니다. |
|
HTTP_SERVICE_CONFIG_URLACL_SET 구조체입니다. |
|
HTTP_SERVICE_CONFIG_TIMEOUT_KEY 구조체입니다. 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 반환합니다.
함수가 실패하면 다음 오류 코드 중 하나를 반환합니다.
| 값 | 의미 |
|---|---|
|
매개 변수 중 하나가 잘못되었습니다. |
|
WinError.h에 정의된 시스템 오류 코드 입니다. |
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | http.h |
| 라이브러리 | Httpapi.lib |
| DLL | Httpapi.dll |