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에 의해 정의됩니다.
구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 오류 값만 나타내지 않습니다.
| 반환 코드 | 설명 |
|---|---|
|
포인터가 잘못되었습니다.
값: 0x80004003 |
설명
열거형은 호출 시 컴퓨터의 디바이스 스냅샷 추가 및 제거된 디바이스를 반영하지 않습니다. 디바이스가 컴퓨터에서 추가되거나 제거될 때 알림을 받으려면 DDiscMaster2Events 인터페이스를 구현합니다 .
단일 식별자를 검색하려면 IDiscMaster2::get_Item 속성을 참조하세요.
디바이스 식별자는 Windows 플러그 앤 플레이에서 인식되는 지정된 디바이스에 대해 고유하고 정적임을 보장합니다. 식별자를 사용자의 기본 버너를 저장하는 키 값으로 사용할 수 있으며 고급 애플리케이션에서 다른 디바이스별 정적 정보(예: VendorID 및 ProductID)를 캐시하는 데 사용할 수도 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | imapi2.h |