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

아티클
02/29/2024

Rename 메서드는 현재 스토리지의 이름을 바꿉니다.

구문

HRESULT Rename(
  [in] UINT          fuMode,
  [in] LPWSTR        pwszNewName,
  [in] IWMDMProgress *pProgress
);

매개 변수

[in] fuMode

이름 바꾸기 작업에 사용되는 처리 모드입니다. 다음 두 모드 중 정확히 하나를 지정합니다. 두 모드를 모두 지정하면 블록 모드가 사용됩니다.

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

[in] pwszNewName

새 이름을 지정하는 와이드 문자 null로 끝나는 문자열에 대한 포인터입니다.

[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가 속한 개체가 읽기 작업이 완료될 때까지 제거되지 않도록 해야 합니다. 이 개체는 종료 알림을 받은 후에만 제거할 수 있습니다. 이렇게 하지 않으면 액세스 위반이 발생합니다.