IWMDMStorageControl::Move 메서드(mswmdm.h)

아티클
02/29/2024

Move 메서드는 현재 스토리지를 디바이스의 새 위치로 이동합니다.

구문

HRESULT Move(
  [in] UINT          fuMode,
  [in] IWMDMStorage  *pTargetObject,
  [in] IWMDMProgress *pProgress
);

매개 변수

[in] fuMode

이동 작업 및 수행할 이동 유형을 호출할 처리 모드입니다. 다음 두 모드 중 정확히 하나를 지정합니다. 두 모드를 모두 지정하면 블록 모드가 사용됩니다.

Mode	Description
WMDM_MODE_BLOCK	작업은 블록 모드 처리를 사용하여 수행됩니다. 작업이 완료될 때까지 호출이 반환되지 않습니다.
WMDM_MODE_THREAD	작업은 스레드 모드 처리를 사용하여 수행됩니다. 호출은 즉시 반환되고 작업은 백그라운드 스레드에서 수행됩니다.

다음 표에는 개체가 이동되는 위치를 나타내는 플래그가 나열되어 있습니다. 이 테이블의 한 값은 비트 OR을 사용하여 이전 Mode 테이블의 값 하나와 결합됩니다.

플래그	설명
WMDM_STORAGECONTROL_INSERTBEFORE	개체가 대상 개체 앞에 삽입됩니다.
WMDM_STORAGECONTROL_INSERTINTO	개체가 대상 개체에 삽입됩니다.
WMDM_STORAGECONTROL_INSERTAFTER	개체는 대상 개체 뒤에 삽입됩니다.

[in] pTargetObject

현재 개체를 배치하려는 이전 또는 이후 개체에 대한 포인터입니다.

[in] pProgress

진행 중인 작업의 진행률을 추적하기 위해 애플리케이션에서 구현한 IWMDMProgress 인터페이스에 대한 선택적 포인터입니다.

반환 값

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

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

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

설명

파일 또는 디렉터리를 동일한 루트 스토리지 내에서만 이동할 수 있습니다.

WMDM_MODE_THREAD 플래그가 지정된 경우 IWMDMProgress2::End2 또는 IWMDMProgress3::End3을 호출하여 완료 상태 가져와야 합니다. 이러한 메서드는 작업이 완료되었는지 확인하고 성공 또는 실패 정보가 포함된 HRESULT도 반환합니다.

애플리케이션이 WMDM_MODE_THREAD 사용하고 null이 아닌 pProgress 매개 변수를 전달하는 경우 Windows Media 장치 관리자 이 개체에 진행률 알림을 보내기 때문에 pProgress가 속한 개체가 이동 작업이 완료될 때까지 제거되지 않도록 해야 합니다. 이 개체는 종료 알림을 받은 후에만 제거할 수 있습니다. 이렇게 하지 않으면 액세스 위반이 발생합니다.