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 값 | 의미 |
|---|---|
|
IP 수신 대기 목록을 쿼리합니다. |
|
SSL 저장소에서 특정 인증서 레코드를 쿼리합니다. |
|
URL 예약 정보를 쿼리합니다. |
|
HTTP Server API 전체 연결 시간 제한을 쿼리합니다.
Windows Vista 이상: 이 열거형이 지원됩니다. |
|
특정 인증서 레코드에 대한 SNI(SSL 서버 이름 표시) 저장소를 쿼리합니다.
Windows 8 이상: 이 열거형 값이 지원됩니다. |
|
포트에서 SSL CCS(Centralized Certificate Store) 레코드에 대한 SSL 구성을 쿼리합니다. 포트는 pInputConfigInfo 매개 변수에 전달하는 HTTP_SERVICE_CONFIG_SSL_CCS_QUERY 구조체의 KeyDesc 멤버에 의해 지정됩니다.
Windows 8 이상: 이 열거형 값이 지원됩니다. |
[in, optional] pInput
다음 표에서 콘텐츠가 쿼리 및 ConfigId 와 상관 관계가 있는 형식을 추가로 정의하는 구조체에 대한 포인터입니다.
| ConfigId 값 | 의미 |
|---|---|
|
입력 데이터가 없습니다. 을 NULL로 설정합니다. |
|
HTTP_SERVICE_CONFIG_SSL_QUERY 구조체입니다. |
|
HTTP_SERVICE_CONFIG_URLACL_QUERY 구조체입니다. |
|
HTTP_SERVICE_CONFIG_TIMEOUT_KEY 구조체입니다. Windows Vista 이상: 이 구조는 지원됩니다. |
|
HTTP_SERVICE_CONFIG_SSL_SNI_QUERY 구조체입니다. Windows 8 이상: 이 구조가 지원됩니다. |
|
HTTP_SERVICE_CONFIG_SSL_CCS_QUERY 구조체입니다. Windows 8 이상: 이 구조가 지원됩니다. |
자세한 내용은 적절한 쿼리 구조를 참조하세요.
[in, optional] InputLength
pInputConfigInfo 버퍼의 크기(바이트)입니다.
[in, out, optional] pOutput
쿼리 결과가 반환되는 버퍼에 대한 포인터입니다. 이 버퍼의 형식은 ConfigId와 상관 관계가 있습니다.
| ConfigId 값 | 의미 |
|---|---|
|
|
|
HTTP_SERVICE_CONFIG_SSL_SET 구조체입니다. |
|
HTTP_SERVICE_CONFIG_URLACL_SET 구조체입니다. |
|
데이터 형식을 HTTP_SERVICE_CONFIG_TIMEOUT_PARAM . Windows Vista 이상: 이 구조는 지원됩니다. |
|
HTTP_SERVICE_CONFIG_SSL_SNI_SET 구조체입니다. Windows 8 이상: 이 구조가 지원됩니다. |
|
HTTP_SERVICE_CONFIG_SSL_CCS_SET 구조체입니다. Windows 8 이상: 이 구조가 지원됩니다. |
[in, optional] OutputLength
pOutputConfigInfo 버퍼의 크기(바이트)입니다.
[out, optional] pReturnLength
출력 버퍼에 쓸 바이트 수를 수신하는 변수에 대한 포인터입니다. 출력 버퍼가 너무 작으면 반환 값이 ERROR_INSUFFICIENT_BUFFER 호출이 실패합니다. pReturnLength가 가리키는 값을 사용하여 버퍼가 호출에 성공하는 데 필요한 최소 길이를 결정할 수 있습니다.
[in] pOverlapped
비동기 작업을 위해 예약되며 NULL로 설정해야 합니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 값 | 의미 |
|---|---|
|
매개 변수 중 하나가 잘못되었습니다. |
|
pOutputConfigInfo가 가리키는 버퍼가 너무 작아서 출력 데이터를 받을 수 없습니다. 종료 시 pReturnLength 가 가리키는 크기만큼 큰 버퍼를 사용하여 함수를 다시 호출합니다. |
|
pOutputConfigInfo가 가리키는 버퍼가 너무 작아서 출력 데이터를 받을 수 없습니다. 종료 시 pReturnLength 가 가리키는 크기만큼 큰 버퍼를 사용하여 함수를 다시 호출합니다. |
|
지정된 조건을 충족하는 반환할 항목이 더 이상 없습니다. |
|
WinError.h에 정의된 시스템 오류 코드 입니다. |
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | http.h |
| 라이브러리 | Httpapi.lib |
| DLL | Httpapi.dll |