MediaCollection.getStringCollectionByQuery 메서드

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

getStringCollectionByQuery 메서드는 쿼리 조건과 일치하는 모든 문자열을 포함하는 StringCollection 개체를 검색합니다.

구문

retVal = MediaCollection.getStringCollectionByQuery(
  attribute,
  query,
  mediaType,
  sortAttribute,
  sortAscending
)

매개 변수

특성 [in]

특성 이름을 포함하는 문자열입니다.

쿼리 [in]

쿼리 개체입니다.

mediaType [in]

미디어 형식을 포함하는 문자열입니다. "audio", "video", "photo", "playlist" 또는 "other" 값 중 하나를 포함해야 합니다.

sortAttribute [in]

정렬에 사용되는 특성 이름을 포함하는 문자열입니다. 빈 문자열("")은 정렬이 적용되지 않음을 의미합니다.

sortAscending [in]

부울, True이면 StringCollection 을 오름차순으로 정렬해야 합니다.

반환 값

이 메서드는 StringCollection 개체를 반환합니다.

설명

쿼리를 사용하는 복합 쿼리 는 대/소문자를 구분하지 않습니다.

쿼리 매개 변수로 지정된 복합 쿼리에 MediaType 특성에 빌드된 조건이 포함된 경우 해당 조건은 무시됩니다. mediaType 매개 변수의 값은 항상 사용됩니다. 예를 들어 복합 쿼리에 "MediaType Equals audio" 조건이 포함되어 있고 mediaType 매개 변수 값이 "video"인 경우 결과 재생 목록에는 비디오 항목만 포함됩니다.

요구 사항

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

추가 정보

MediaCollection 개체

MediaType 특성

쿼리 개체