IWMDMStorageControl::D elete 메서드(mswmdm.h)

아티클
03/05/2024

Delete 메서드는 이 스토리지를 영구적으로 삭제합니다.

구문

HRESULT Delete(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

매개 변수

[in] fuMode

비트 OR와 결합된 다음 플래그 중 하나 또는 두 개. 처음 두 모드 중 정확히 하나를 지정합니다. 세 번째 모드는 선택 사항입니다.

Mode	Description
WMDM_MODE_BLOCK	작업은 블록 모드(동기) 처리를 사용하여 수행됩니다. 작업이 완료될 때까지 호출이 반환되지 않습니다.
WMDM_MODE_THREAD	작업은 스레드 모드(비동기) 처리를 사용하여 수행됩니다. 호출은 즉시 반환되고 작업은 백그라운드 스레드에서 수행됩니다.
WMDM_MODE_RECURSIVE	스토리지 개체가 폴더인 경우 해당 폴더와 해당 내용, 모든 하위 폴더 및 해당 콘텐츠가 삭제됩니다.

[in] pProgress

Windows Media 장치 관리자 애플리케이션에 진행률을 다시 보고하는 데 사용할 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가 속한 개체가 삭제 작업이 완료될 때까지 제거되지 않도록 해야 합니다. 이 개체는 종료 알림을 받은 후에만 제거할 수 있습니다. 이렇게 하지 않으면 액세스 위반이 발생합니다.