IWMPMediaCollection::remove 메서드

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 remove 미디어 컬렉션에서 지정된 항목을 제거합니다.

구문

public void remove(
  IWMPMedia pItem,
  System.Boolean varfDeleteFile
);

Public Sub remove( _
  ByVal pItem As IWMPMedia, _
  ByVal varfDeleteFile As System.Boolean _
)
Implements IWMPMediaCollection.remove

매개 변수

pItem [in]

제거할 항목을 식별하는 WMPLib.IWMPMedia 인터페이스입니다.

varfDeleteFile [in]

메서드가 라이브러리에서 지정된 항목을 제거할지 여부를 지정하는 System.Boolean 값입니다.

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

이 메서드는 라이브러리에서 항목을 삭제합니다. 이 메서드는 사용자의 컴퓨터에서 파일을 삭제하지 않습니다.

이 메서드를 호출하기 전에 라이브러리에 대한 읽기 권한이 있어야 합니다. 자세한 내용은 라이브러리 액세스를 참조하세요.

예제

다음 예제에서는 사용자에게 메시지를 표시한 후 를 사용하여 remove미디어 컬렉션의 첫 번째 미디어 항목을 영구적으로 삭제합니다. AxWMPLib.AxWindowsMediaPlayer 개체는 player라는 변수로 표시됩니다.

// Get an interface to the first item from the media collection. 
WMPLib.IWMPMedia3 media = (WMPLib.IWMPMedia3)player.mediaCollection.getAll().get_Item(0);

// Store the name of the retrieved media item.
string mediaName = media.name;

// Prepare a message, a caption and buttons for the user prompt.
string message = ("OK to permanently delete " + mediaName + "?");
string caption = "Confirm deletion";
System.Windows.Forms.MessageBoxButtons buttons = System.Windows.Forms.MessageBoxButtons.OKCancel;

// Prompt the user for permission to delete the object.
System.Windows.Forms.DialogResult result = System.Windows.Forms.MessageBox.Show(message, caption, buttons);

// Check the user response.
if (result == System.Windows.Forms.DialogResult.OK)
{
    // Permanently delete the item.
    player.mediaCollection.remove(media, true);

    // Report that the item was deleted.
    System.Windows.Forms.MessageBox.Show("Deleted item " + mediaName);
}

' Get an interface to the first item from the media collection. 
Dim media As WMPLib.IWMPMedia3 = player.mediaCollection.getAll().Item(0)

' Store the name of the retrieved media item.
Dim mediaName As String = media.name

' Prepare a message, a caption and buttons for the user prompt.
Dim message As String = ("OK to permanently delete " + mediaName + "?")
Dim caption As String = "Confirm deletion"
Dim buttons As System.Windows.Forms.MessageBoxButtons = System.Windows.Forms.MessageBoxButtons.OKCancel

' Prompt the user for permission to delete the object.
Dim result As System.Windows.Forms.DialogResult = System.Windows.Forms.MessageBox.Show(message, caption, buttons)

' Check the user response.
If (result = System.Windows.Forms.DialogResult.OK) Then

    ' Permanently delete the item.
    player.mediaCollection.remove(media, True)

    ' Report that the item was deleted.
    System.Windows.Forms.MessageBox.Show("Deleted item " + mediaName)

End If

요구 사항

요구 사항	값
버전	Windows 미디어 플레이어 9 시리즈 이상
네임스페이스	WMPLib
어셈블리	Interop.WMPLib.dll(Interop.WMPLib.dll.dll)

추가 정보

IWMPMedia 인터페이스(VB 및 C#)

IWMPMediaCollection 인터페이스(VB 및 C#)

IWMPMediaCollection.add(VB 및 C#)