Método IDiscMaster2::get__NewEnum (imapi2.h)
Recupera una lista de los dispositivos CD y DVD instalados en el equipo.
Sintaxis
HRESULT get__NewEnum(
[out] IEnumVARIANT **ppunk
);
Parámetros
[out] ppunk
Interfaz IEnumVariant que se usa para enumerar los dispositivos cd y DVD instalados en el equipo. Los elementos de la enumeración son variantes cuyo tipo es VT_BSTR. Use el miembro bstrVal para recuperar el identificador único del dispositivo.
Valor devuelto
S_OK se devuelve cuando el número de elementos solicitados (celt) se devuelve correctamente o el número de elementos devueltos (pceltFetched) es menor que el número de elementos solicitados. Los parámetros celt y pceltFetched se definen mediante IEnumVariant.
Se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:
| Código devuelto | Descripción |
|---|---|
|
El puntero no es válido.
Valor: 0x80004003 |
Comentarios
La enumeración es una instantánea de los dispositivos del equipo en el momento de la llamada y no reflejará los dispositivos que se agregan y quitan. Para recibir una notificación cuando se agrega o quita un dispositivo del equipo, implemente la interfaz DDiscMaster2Events .
Para recuperar un único identificador, consulte la propiedad IDiscMaster2::get_Item .
Se garantiza que el identificador de dispositivo es único y estático para un dispositivo determinado, tal como lo reconoce Windows Plug and Play. Puede usar el identificador como valor clave para guardar el quemador predeterminado del usuario y también se puede usar para almacenar en caché otra información estática específica del dispositivo (por ejemplo, VendorID y ProductID) mediante una aplicación avanzada.
Requisitos
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | imapi2.h |