IMFHttpDownloadRequest::QueryHeader 메서드(mfidl.h)

  • 아티클

이전에 보낸 HTTP 또는 HTTPS 요청에 대한 응답에서 지정된 HTTP 헤더의 값을 검색하기 위해 Microsoft Media Foundation에서 호출합니다. Media Foundation은 EndReceiveResponse 메서드를 성공적으로 호출한 후에만 이 메서드를 호출합니다.

구문

HRESULT QueryHeader(
  [in]  LPCWSTR szHeaderName,
  [in]  DWORD   dwIndex,
  [out] LPWSTR  *ppszHeaderValue
);

매개 변수

[in] szHeaderName

값을 쿼리할 HTTP 헤더의 이름입니다.

[in] dwIndex

응답에 동일한 이름의 여러 헤더가 포함된 경우 지정된 헤더의 인덱스 번호입니다. 값이 0이면 지정된 이름의 첫 번째 헤더 값이 요청되고 1은 두 번째 헤더가 요청되었음을 나타냅니다.

[out] ppszHeaderValue

캐리지 리턴 또는 줄 바꿈 문자를 포함하지 않고 요청된 헤더의 값으로 설정합니다. ppszHeaderValue에 대한 메모리는 CoTaskMemAlloc과 함께 할당되어야 하며 CoTaskMemFree를 사용하여 Media Foundation에서 해제됩니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드 설명
S_OK
 지정된 인덱스가 있는 지정된 헤더의 값을 반환했습니다.
E_OUTOFMEMORY
 메모리가 부족하여 작업을 완료할 수 없습니다.
E_POINTER
 ppszHeaderValue 매개 변수가 잘못된 포인터입니다.
MF_E_OUT_OF_RANGE
 dwIndex 매개 변수 값이 범위를 벗어났습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 10, 버전 1703 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 mfidl.h
라이브러리 Mfplat.lib; Mfplat.dll

참고 항목

IMFHttpDownloadRequest