IMFHttpDownloadSessionProvider::CreateHttpDownloadSession 메서드(mfidl.h)

기본 구현을 사용하는 대신 HTTP 또는 HTTPS URL을 열기 위해 Microsoft Media Foundation에서 호출합니다.

구문

HRESULT CreateHttpDownloadSession(
  [in]  LPCWSTR                wszScheme,
  [out] IMFHttpDownloadSession **ppDownloadSession
);

매개 변수

[in] wszScheme

IMFHttpDownloadSession이 요청되는 프로토콜의 이름입니다. Microsoft Media Foundation은 애플리케이션이 Media Foundation 원본 확인자를 제공한 URL의 프로토콜 체계를 지정합니다. 유효한 값에는 HTTP의 경우 "http", HTTPS의 경우 "https"가 포함됩니다. URL 체계 이름은 일반적으로 대/소문자를 구분하지 않습니다.

[out] ppDownloadSession

성공적으로 실행되면 매개 변수가 IMFHttpDownloadSession 인터페이스에 대한 포인터로 설정됩니다 . 반환된 인터페이스는 Microsoft Media Foundation에서 단일 HTTP 또는 HTTPS URL을 여는 데 사용됩니다.

반환 값

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

반환 코드	설명
S_OK	IMFHttpDownloadSession 개체를 만들었습니다.
E_INVALIDARG	wszScheme 매개 변수에 지정된 값이 잘못되었습니다.
E_POINTER	ppDownloadSession 매개 변수가 잘못된 포인터입니다.
E_OUTOFMEMORY	메모리가 부족하여 작업을 완료할 수 없습니다.

설명

"https"를 wszScheme 값으로 지정한다고 해서 HTTPS가 IMFhttpDownloadSession::CreateRequest의 요청별 기준으로 지정되는 특정 요청에 사용된다는 의미는 아닙니다.

요구 사항

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

참고 항목

IMFHttpDownloadSessionProvider