IWMDMStorage3::SetEnumPreference 메서드(mswmdm.h)

아티클
02/29/2024

SetEnumPreference 메서드는 스토리지에 대한 기본 보기 모드를 설정합니다.

구문

HRESULT SetEnumPreference(
  [in, out] WMDM_STORAGE_ENUM_MODE *pMode,
  [in]      DWORD                  nViews,
  [in]      WMDMMetadataView       *pViews
);

매개 변수

[in, out] pMode

스토리지 열거자의 원하는 모드입니다. 모드에 대한 자세한 내용은 WMDM_STORAGE_ENUM_MODE 참조하세요. pMode 값이 ENUM_MODE_USE_DEVICE_PREF 설정된 경우 반환 시 디바이스 기본 설정에 따라 ENUM_MODE_RAW 또는 ENUM_MODE_METADATA_VIEWS 설정됩니다.

[in] nViews

제공된 뷰 정의 수입니다.

pMode 값이 ENUM_MODE_RAW 경우 또는 pMode 값이 ENUM_MODE_USE_DEVICE_PREF 디바이스에서 메타데이터 보기를 선호하지 않는 경우 이 매개 변수는 무시됩니다.

pMode 값이 ENUM_MODE_METADATA_VIEWS 또는 pMode 값이 ENUM_MODE_USE_DEVICE_PREF 디바이스에서 메타데이터 보기를 선호하는 경우 이 매개 변수는 여전히 0일 수 있습니다. 이 경우 Windows Media 장치 관리자 기본 메타데이터 뷰를 사용합니다.

nViews 값이 0이면 ppViews는NULL이어야 합니다. nViews 값이 0이 아닌 경우 ppViews는 nViews 요소가 있는 WMDMMetadataView 구조체의 배열을 가리킵니다.

[in] pViews

보기 정의의 배열입니다. 배열의 길이는 nViews와 같아야 합니다.

pMode 값이 ENUM_MODE_RAW 경우 또는 pMode 값이 ENUM_MODE_USE_DEVICE_PREF 디바이스에서 메타데이터 보기를 선호하지 않는 경우 이 매개 변수는 무시됩니다.

pMode 값이 ENUM_MODE_METADATA_VIEWS 또는 pMode 값이 ENUM_MODE_USE_DEVICE_PREF 디바이스에서 메타데이터 보기를 선호하는 경우 이 매개 변수는 여전히 NULL일 수 있습니다. 이 경우 Windows Media 장치 관리자 기본 메타데이터 뷰를 사용합니다.

nViews 값이 0인 경우 이 매개 변수의 값은 NULL이어야 합니다. nViews 값이 0이 아닌 경우 ppViews는 nViews 요소가 있는 WMDMMetadataView 구조체의 배열을 가리킵니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 다음 표에는 가능한 모든 값이 나열됩니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_OUTOFMEMORY	항목을 할당할 메모리가 부족합니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
WMDM_E_NOT_CERTIFIED	호출자에게 이 작업을 실행할 권한이 없습니다.
WMDM_E_NOTSUPPORTED	개체는 이 메서드를 지원하지 않습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

설명

Windows Media 장치 관리자 디바이스에서 콘텐츠의 메타데이터 보기를 표시할 수 있습니다. 최상위 스토리지의 모든 콘텐츠(예: 내부 메모리 또는 스토리지 카드)를 살펴보고 콘텐츠의 메타데이터로 구성된 콘텐츠를 제공하는 스토리지 열거자를 반환합니다. 메타데이터 뷰의 정의는 WMDMMetadataView 구조를 통해 제공됩니다.

이 동작은 pMode 매개 변수에 의해 제어됩니다. pMode가 ENUM_MODE_RAW 설정되면 Windows Media 장치 관리자 디바이스 스토리지에서 파일 시스템의 계층 구조를 미러링하는 열거자를 반환합니다. pMode가 ENUM_MODE_METADATA_VIEWS 설정되면 Windows Media 장치 관리자 메타데이터 뷰를 생성합니다.

디바이스는 디바이스가 설치될 때 디바이스 매개 변수 UseMetadataViews 를 설정하여 기본 설정을 나타냅니다. UseMetadataViews에 대한 자세한 내용은 디바이스 매개 변수를 참조하세요. 애플리케이션이 디바이스가 반환된 스토리지 열거자의 종류를 결정할 수 있게 하는 경우 pMode 를 ENUM_MODE_USE_DEVICE_PREF 설정해야 합니다.

이 메서드가 호출되면 나중에 IWMDMStorage::EnumStorage 에 대한 호출이 이 메서드에서 설정한 스토리지 열거형 기본 설정에 따라 작동합니다. 이 메서드를 다시 호출하여 후속 IWMDMStorage::EnumStorage 호출의 동작을 변경할 수 있습니다.

이 메서드는 일반적으로 최상위 스토리지에서 호출되어야 합니다. 이 메서드가 메타데이터 보기의 스토리지에서 호출되면 WMDM_E_NOTSUPPORTED 반환됩니다.