HttpQueryInfoW 함수(wininet.h)
HTTP 요청과 연결된 헤더 정보를 검색합니다.
구문
BOOL HttpQueryInfoW(
[in] HINTERNET hRequest,
[in] DWORD dwInfoLevel,
[in, out] LPVOID lpBuffer,
[in, out] LPDWORD lpdwBufferLength,
[in, out] LPDWORD lpdwIndex
);
매개 변수
[in] hRequest
HttpOpenRequest 또는 InternetOpenUrl 함수에 대한 호출에서 반환되는 핸들입니다.
[in] dwInfoLevel
검색할 특성과 요청을 수정하는 플래그의 조합입니다. 가능한 특성 및 한정자 값 목록은 쿼리 정보 플래그를 참조하세요.
[in, out] lpBuffer
요청된 정보를 받을 버퍼에 대한 포인터입니다. 이 매개 변수는 NULL이 아니어야 합니다.
[in, out] lpdwBufferLength
항목에서 lpvBuffer가 가리키는 버퍼의 크기(바이트)를 포함하는 변수에 대한 포인터입니다.
함수가 성공적으로 반환되면 이 변수에는 버퍼에 기록된 정보의 바이트 수가 포함됩니다. 문자열의 경우 바이트 수에는 문자열의 종료 null 문자가 포함되지 않습니다.
함수인 경우
는lpdwBufferLength가 가리키는 변수에 요청된 정보를 받을 수 있을 만큼 큰 버퍼의 크기(바이트)를 포함하는 확장된 오류 코드 ERROR_INSUFFICIENT_BUFFER 함께 실패합니다. 호출하는 애플리케이션은 이 크기 이상의 버퍼를 할당하고 함수를 다시 호출할 수 있습니다.
[in, out] lpdwIndex
이름이 같은 여러 헤더를 열거하는 데 사용되는 0부터 시작하는 헤더 인덱스에 대한 포인터입니다. 함수를 호출할 때 이 매개 변수는 반환할 지정된 헤더의 인덱스입니다. 함수가 반환되면 이 매개 변수는 다음 헤더의 인덱스입니다. 다음 인덱스 를 찾을 수 없으면 ERROR_HTTP_HEADER_NOT_FOUND 반환됩니다.
반환 값
성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
HttpQueryInfo에서 다음 유형의 데이터를 검색할 수 있습니다.
- 문자열(기본값)
- SYSTEMTIME (날짜)
- DWORD ( HTTP_QUERY_FLAG_NUMBER 사용된 경우 STATUS_CODE, CONTENT_LENGTH 등의 경우)
애플리케이션에서 데이터를 문자열이 아닌 데이터 형식으로 반환해야 하는 경우 dwInfoLevel에 전달된 특성과 함께 적절한 한정자를 포함해야 합니다.
HttpQueryInfo 함수는 ISO-8859-1 문자(HttpQueryInfoA 함수)용 Microsoft Internet Explorer 3.0 및 ISO-8859-1 문자(HttpQueryInfoA 함수)의 경우 인터넷 Explorer 4.0 이상 및 UTF-16LE 문자로 변환된 ISO-8859-1 문자에서 사용할 수 있습니다.( HttpQueryInfoW 함수).
WinINet API의 다른 모든 측면과 마찬가지로 이 함수는 DllMain 내에서 또는 전역 개체의 생성자 및 소멸자에서 안전하게 호출할 수 없습니다.
참고
wininet.h 헤더는 HTTPQueryInfo를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wininet.h |
| 라이브러리 | Wininet.lib |
| DLL | Wininet.dll |