IWMDMStorage4::SetReferences 메서드(mswmdm.h)

아티클
02/29/2024

SetReferences 메서드는 스토리지에서 보유한 기존 참조를 덮어쓰는 참조(예: 재생 목록 또는 앨범)가 있는 스토리지에 포함된 참조를 설정합니다.

구문

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IWMDMStorage **ppIWMDMStorage
);

매개 변수

[in] dwRefs

ppIWMDMStorage의 IWMDMStorage 인터페이스 포인터 수입니다. 0은 허용되는 값이며 스토리지에서 모든 참조를 지웁니다. 이 경우 스토리지 자체는 삭제되지 않습니다.

[in] ppIWMDMStorage

스토리지에서 참조할 IWMDMStorage 인터페이스 포인터의 배열에 대한 포인터입니다. 이 순서는 스토리지에서 유지됩니다. dwRefs도 0인 경우 NULL은 허용되는 값입니다. 호출자는 이 배열을 할당하고 해제할 책임이 있습니다.

반환 값

이 메서드는 HRESULT를 반환합니다. Windows Media 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스를 반환할 수 있습니다.

표준 COM 오류 코드
HRESULT 값으로 변환된 Windows 오류 코드
Windows Media 장치 관리자 오류 코드

가능한 오류 코드의 광범위한 목록은 오류 코드를 참조하세요.

설명

이 메서드는 재생 목록 또는 앨범과 같은 참조로 구성된 개체에서 참조를 설정하는 데 사용됩니다. 디바이스에서 메타데이터를 지원하지 않는 경우 이 메서드는 지원되지 않을 수 있습니다.

유효한 모든 IWMDMStorage 개체는 ppIWMDMStorage 배열에 포함될 수 있습니다. 여기에는 참조 자체를 지정하는 폴더 및 기타 스토리지(예: 재생 목록 재생 목록 만들기)가 포함됩니다. 디바이스 자체는 참조 개체의 특정 사례를 처리하는 방법을 결정합니다. Windows Media 장치 관리자 IWMDMStorage 유효성 이외의 규칙을 적용하지 않습니다. 중첩된 재생 목록 참조가 포함된 재생 목록의 경우를 고려합니다. 한 디바이스에서는 이 작업이 허용되지 않으며 SetReferences가 실패합니다 . 다른 디바이스에서는 이 작업이 허용됩니다. 재생은 포함된 참조의 전체 집합을 깊이 우선 순서로 트래버스하기만 하면 됩니다.

IWMDMStorage4 인터페이스 포인터가 디바이스에 더 이상 존재하지 않는 스토리지에 해당하는 상황이 발생할 수 있습니다. 이 경우 WMDM_E_INTERFACEDEAD 반환됩니다.