HttpQueryInfoA 함수(wininet.h)

  • 아티클

HTTP 요청과 연결된 헤더 정보를 검색합니다.

구문

BOOL HttpQueryInfoA(
  [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 함수).

참고HttpQueryInfoA 함수는 헤더를 ANSI 문자가 아닌 ISO-8859-1 문자로 나타냅니다. HttpQueryInfoW 함수는 헤더를 UTF-16LE 문자로 변환된 ISO-8859-1 문자로 나타냅니다. 따라서 헤더에 ASCII가 아닌 문자를 포함할 수 있는 경우 HttpQueryInfoW 함수를 사용하는 것이 안전하지 않습니다. 대신 애플리케이션은 Codepage 매개 변수가 28591로 설정된 MultiByteToWideChar 및 WideCharToMultiByte 함수를 사용하여 ANSI 문자와 UTF-16LE 문자 간에 매핑할 수 있습니다.
 
HttpQueryInfo 함수를 호출하는 예제 코드는 HTTP 헤더 검색을 참조하세요.

WinINet API의 다른 모든 측면과 마찬가지로 이 함수는 DllMain 내에서 또는 전역 개체의 생성자 및 소멸자에서 안전하게 호출할 수 없습니다.

참고 WinINet은 서버 구현을 지원하지 않습니다. 또한 서비스에서 사용하면 안 됩니다. 서버 구현 또는 서비스의 경우 WinHTTP(Microsoft Windows HTTP 서비스)를 사용합니다.
 

참고

wininet.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 HttpQueryInfo를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 wininet.h
라이브러리 Wininet.lib
DLL Wininet.dll

추가 정보

HTTP 세션

HTTP 헤더 검색

WinINet 함수