IDiscMaster2::get__NewEnum 메서드(imapi2.h)

컴퓨터에 설치된 CD 및 DVD 디바이스 목록을 검색합니다.

구문

HRESULT get__NewEnum(
  [out] IEnumVARIANT **ppunk
);

매개 변수

[out] ppunk

컴퓨터에 설치된 CD 및 DVD 디바이스를 열거하는 데 사용하는 IEnumVariant 인터페이스입니다. 열거형의 항목은 형식이 VT_BSTR 변형입니다. bstrVal 멤버를 사용하여 디바이스의 고유 식별자를 검색합니다.

반환 값

요청된 요소 수(셀트)가 성공적으로 반환되거나 반환된 항목 수(pceltFetched)가 요청된 요소 수보다 작으면 S_OK 반환됩니다. celt 및 pceltFetched 매개 변수는 IEnumVariant에 의해 정의됩니다.

구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 오류 값만 나타내지 않습니다.

반환 코드	설명
E_POINTER	포인터가 잘못되었습니다. 값: 0x80004003

설명

열거형은 호출 시 컴퓨터의 디바이스 스냅샷 추가 및 제거된 디바이스를 반영하지 않습니다. 디바이스가 컴퓨터에서 추가되거나 제거될 때 알림을 받으려면 DDiscMaster2Events 인터페이스를 구현합니다 .

단일 식별자를 검색하려면 IDiscMaster2::get_Item 속성을 참조하세요.

디바이스 식별자는 Windows 플러그 앤 플레이에서 인식되는 지정된 디바이스에 대해 고유하고 정적임을 보장합니다. 식별자를 사용자의 기본 버너를 저장하는 키 값으로 사용할 수 있으며 고급 애플리케이션에서 다른 디바이스별 정적 정보(예: VendorID 및 ProductID)를 캐시하는 데 사용할 수도 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	imapi2.h

참고 항목

IDiscMaster2

IDiscMaster2::get_Count