Metodo IDiscMaster2::get__NewEnum (imapi2.h)

Recupera un elenco dei dispositivi CD e DVD installati nel computer.

Sintassi

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

Parametri

[out] ppunk

Interfaccia IEnumVariant usata per enumerare i dispositivi CD e DVD installati nel computer. Gli elementi dell'enumerazione sono varianti il cui tipo è VT_BSTR. Usare il membro bstrVal per recuperare l'identificatore univoco del dispositivo.

Valore restituito

S_OK viene restituito quando il numero di elementi richiesti (celt) viene restituito correttamente o il numero di elementi restituiti (pceltFetched) è minore del numero di elementi richiesti. I parametri celt e pceltFetched sono definiti da IEnumVariant.

Altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito	Descrizione
E_POINTER	Puntatore non valido. Valore: 0x80004003

Commenti

L'enumerazione è uno snapshot dei dispositivi nel computer al momento della chiamata e non riflette i dispositivi aggiunti e rimossi. Per ricevere una notifica quando un dispositivo viene aggiunto o rimosso dal computer, implementare l'interfaccia DDiscMaster2Events .

Per recuperare un singolo identificatore, vedere la proprietà IDiscMaster2::get_Item .

L'identificatore del dispositivo è garantito che sia univoco e statico per un determinato dispositivo come riconosciuto da Plug and Play di Windows. È possibile usare l'identificatore come valore della chiave per salvare il masterizzatore predefinito dell'utente e può essere usato anche per memorizzare nella cache altre informazioni statiche specifiche del dispositivo (ad esempio VendorID e ProductID) da un'applicazione avanzata.

Requisiti

Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2.h

Vedi anche

IDiscMaster2

IDiscMaster2::get_Count