다음을 통해 공유

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 (STATUS_CODE, CONTENT_LENGTH등, HTTP_QUERY_FLAG_NUMBER 사용된 경우)

애플리케이션에서 데이터를 문자열 이외의 데이터 형식으로 반환해야 하는 경우 dwInfoLevel전달된 특성과 함께 적절한 한정자를 포함해야 합니다.

HttpQueryInfo 함수는 ISO-8859-1 문자(httpQueryInfoA 함수)용 Microsoft Internet Explorer 3.0 및 Internet Explorer 4에서 사용할 수 있습니다. ISO-8859-1 문자(httpQueryInfoA 함수) 및 UTF-16LE 문자로 변환된 ISO-8859-1 문자의 경우 0 이상입니다. (HttpQueryInfoW 함수).

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

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

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

메모

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

요구 사항

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

참고 항목

http 세션

http 헤더 검색하는

winINet Functions