IMFContentEnabler::GetEnableURL 메서드(mfidl.h)

수동 콘텐츠 사용 작업을 수행하기 위한 URL을 검색합니다.

구문

HRESULT GetEnableURL(
  [out]     LPWSTR              *ppwszURL,
  [out]     DWORD               *pcchURL,
  [in, out] MF_URL_TRUST_STATUS *pTrustStatus
);

매개 변수

[out] ppwszURL

URL이 포함된 버퍼에 대한 포인터를 받습니다. 호출자는 CoTaskMemFree를 호출하여 버퍼에 대한 메모리를 해제해야 합니다.

[out] pcchURL

종료되는 NULL 문자를 포함하여 ppwszURL로 반환된 문자 수를 받습니다.

[in, out] pTrustStatus

URL을 신뢰할 수 있는지 여부를 나타내는 MF_URL_TRUST_STATUS 열거형의 멤버를 받습니다.

반환 값

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
MF_E_NOT_AVAILABLE	사용할 수 있는 URL이 없습니다.

설명

URL로 이동하여 사용 작업을 수행할 수 있는 경우 이 메서드는 URL을 반환합니다. 이러한 URL이 없으면 메서드는 실패 코드를 반환합니다.

URL의 목적은 IMFContentEnabler::GetEnableType을 호출하여 얻은 콘텐츠 인에이블러 형식에 따라 달라집니다.

형식 사용	URL의 목적
개별화	해당 사항 없음
라이선스 취득	라이선스를 얻기 위한 URL입니다. IMFContentEnabler::GetEnableData를 호출하고 HTTP POST 요청으로 URL에 데이터를 제출합니다. 라이선스를 획득할 때 알림을 받으려면 IMFContentEnabler::MonitorEnable을 호출합니다.
해지	사용자가 업데이트된 구성 요소를 다운로드하여 설치할 수 있는 웹 페이지의 URL입니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	mfidl.h
라이브러리	Mfuuid.lib

참고 항목

보호된 미디어 파일을 재생하는 방법

IMFContentEnabler