다음을 통해 공유

HttpQueryServiceConfiguration 함수(http.h)

  • 아티클

HttpQueryServiceConfiguration 함수는 하나 이상의 HTTP Server API 구성 레코드를 검색합니다.

구문

HTTPAPI_LINKAGE ULONG HttpQueryServiceConfiguration(
  [in]                HANDLE                 ServiceHandle,
  [in]                HTTP_SERVICE_CONFIG_ID ConfigId,
  [in, optional]      PVOID                  pInput,
  [in, optional]      ULONG                  InputLength,
  [in, out, optional] PVOID                  pOutput,
  [in, optional]      ULONG                  OutputLength,
  [out, optional]     PULONG                 pReturnLength,
  [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
 특정 인증서 레코드에 대한 SNI(SSL 서버 이름 표시) 저장소를 쿼리합니다.

Windows 8 이상: 이 열거형 값이 지원됩니다.
HttpServiceConfigSslCcsCertInfo
 포트에서 SSL CCS(Centralized Certificate Store) 레코드에 대한 SSL 구성을 쿼리합니다. 포트는 pInputConfigInfo 매개 변수에 전달하는 HTTP_SERVICE_CONFIG_SSL_CCS_QUERY 구조체의 KeyDesc 멤버에 의해 지정됩니다.

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

[in, optional] pInput

다음 표에서 콘텐츠가 쿼리 및 ConfigId 와 상관 관계가 있는 형식을 추가로 정의하는 구조체에 대한 포인터입니다.

ConfigId 값 의미
HttpServiceConfigIPListenList
 입력 데이터가 없습니다. 을 NULL로 설정합니다.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_QUERY 구조체입니다.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_QUERY 구조체입니다.
HttpServiceConfigTimeout

HTTP_SERVICE_CONFIG_TIMEOUT_KEY 구조체입니다.

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

HTTP_SERVICE_CONFIG_SSL_SNI_QUERY 구조체입니다.

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

HTTP_SERVICE_CONFIG_SSL_CCS_QUERY 구조체입니다.

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

자세한 내용은 적절한 쿼리 구조를 참조하세요.

[in, optional] InputLength

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

[in, out, optional] pOutput

쿼리 결과가 반환되는 버퍼에 대한 포인터입니다. 이 버퍼의 형식은 ConfigId와 상관 관계가 있습니다.

ConfigId 값 의미
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY 구조체입니다.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET 구조체입니다.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET 구조체입니다.
HttpServiceConfigTimeout

데이터 형식을 HTTP_SERVICE_CONFIG_TIMEOUT_PARAM .

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

HTTP_SERVICE_CONFIG_SSL_SNI_SET 구조체입니다.

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

HTTP_SERVICE_CONFIG_SSL_CCS_SET 구조체입니다.

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

[in, optional] OutputLength

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

[out, optional] pReturnLength

출력 버퍼에 쓸 바이트 수를 수신하는 변수에 대한 포인터입니다. 출력 버퍼가 너무 작으면 반환 값이 ERROR_INSUFFICIENT_BUFFER 호출이 실패합니다. pReturnLength가 가리키는 값을 사용하여 버퍼가 호출에 성공하는 데 필요한 최소 길이를 결정할 수 있습니다.

[in] pOverlapped

비동기 작업을 위해 예약되며 NULL로 설정해야 합니다.

반환 값

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

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

값 의미
ERROR_INVALID_PARAMETER
 매개 변수 중 하나가 잘못되었습니다.
ERROR_INSUFFICIENT_BUFFER
 pOutputConfigInfo가 가리키는 버퍼가 너무 작아서 출력 데이터를 받을 수 없습니다. 종료 시 pReturnLength 가 가리키는 크기만큼 큰 버퍼를 사용하여 함수를 다시 호출합니다.
ERROR_MORE_DATA
 pOutputConfigInfo가 가리키는 버퍼가 너무 작아서 출력 데이터를 받을 수 없습니다. 종료 시 pReturnLength 가 가리키는 크기만큼 큰 버퍼를 사용하여 함수를 다시 호출합니다.
ERROR_NO_MORE_ITEMS
 지정된 조건을 충족하는 반환할 항목이 더 이상 없습니다.
기타
 WinError.h에 정의된 시스템 오류 코드 입니다.

요구 사항

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

추가 정보

HTTP 서버 API 버전 1.0 함수

HttpDeleteServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration