Método IDiscMaster2::get__NewEnum (imapi2.h)
Recupera uma lista dos dispositivos de CD e DVD instalados no computador.
Sintaxe
HRESULT get__NewEnum(
[out] IEnumVARIANT **ppunk
);
Parâmetros
[out] ppunk
Uma interface IEnumVariant que você usa para enumerar os dispositivos de CD e DVD instalados no computador. Os itens da enumeração são variantes cujo tipo é VT_BSTR. Use o membro bstrVal para recuperar o identificador exclusivo do dispositivo.
Valor retornado
S_OK é retornado quando o número de elementos solicitados (celt) é retornado com êxito ou o número de itens retornados (pceltFetched) é menor que o número de elementos solicitados. Os parâmetros celt e pceltFetched são definidos por IEnumVariant.
Outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro geralmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
| Código de retorno | Descrição |
|---|---|
|
O ponteiro não é válido.
Valor: 0x80004003 |
Comentários
A enumeração é uma instantâneo dos dispositivos no computador no momento da chamada e não refletirá os dispositivos adicionados e removidos. Para receber notificação quando um dispositivo for adicionado ou removido do computador, implemente a interface DDiscMaster2Events .
Para recuperar um único identificador, consulte a propriedade IDiscMaster2::get_Item .
O identificador do dispositivo tem a garantia de ser exclusivo e estático para um determinado dispositivo, conforme reconhecido pelo Windows Plug and Play. Você pode usar o identificador como um valor de chave para salvar o queimador padrão do usuário e também pode ser usado para armazenar em cache outras informações estáticas específicas do dispositivo (por exemplo, VendorID e ProductID) por um aplicativo avançado.
Requisitos
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imapi2.h |