Media.isReadOnlyItem 메서드

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

isReadOnlyItem 메서드는 미디어 항목의 지정된 특성을 편집할 수 있는지 여부를 나타내는 값을 반환합니다.

구문

bRetVal = Media.isReadOnlyItem(
  attribute
)

매개 변수

특성 [in]

테스트할 특성의 이름을 나타내는 문자열입니다. Windows 미디어 플레이어 지원하는 특성에 대한 자세한 내용은 Windows 미디어 플레이어 특성 참조를 참조하세요.

반환 값

이 메서드는 부울을 반환합니다.

설명

특성이 읽기 전용인 경우 setItemInfo 메서드를 사용하여 설정할 수 없습니다. 이 메서드는 다른 버전의 Windows 미디어 플레이어 사용하는 경우 특정 특성에 대해 서로 다른 값을 반환할 수 있습니다.

이 메서드를 사용하려면 라이브러리에 대한 읽기 권한이 필요합니다. 자세한 내용은 라이브러리 액세스를 참조하세요.

Windows 미디어 플레이어 10 Mobile: 이 속성은 항상 true를 반환합니다.

예제

다음 JScript 예제에서는 미디어를 사용합니다. isReadOnlyItem - rwText라는 HTML TEXTAREA 요소를 현재 미디어 항목에 대한 정보로 채웁니다. 이 코드는 특성이 읽기 전용인지 읽기/쓰기인지를 나타내는 텍스트와 함께 현재 미디어 항목의 각 특성을 출력합니다. Player 개체는 ID = "Player"로 만들어졌습니다.

// Store the current media item object.
var cm = Player.currentMedia;

// Create a variable to hold each attribute name.
var atName;

// Loop through the attribute list.
for(var i = 0; i < cm.attributeCount; i++){

   // Get the attribute name.
   atName = cm.getAttributeName(i);

   // Test whether the attribute is read-only.
   var test = ((cm.isReadOnlyItem(atName))?"Read-Only":"Read/Write");

// Print the attribute information to the text area.
   rwText.value += atName + " is " + test;
   rwText.value += "\n";
}

요구 사항

요구 사항	값
버전	Windows 미디어 플레이어 버전 7.0 이상.
DLL	Wmp.dll

추가 정보

Media 개체

Media.setItemInfo

Settings.mediaAccessRights

Settings.requestMediaAccessRights