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 |
---|---|
|
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
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per