Método IDiscRecorder::GetDisplayNames (imapi.h)
Recupera um nome formatado para o gravador que pode ser exibido. O nome consiste no fabricante e no identificador do produto do dispositivo.
Sintaxe
HRESULT GetDisplayNames(
[out] BSTR *pbstrVendorID,
[out] BSTR *pbstrProductID,
[out] BSTR *pbstrRevision
);
Parâmetros
[out] pbstrVendorID
Fornecedor do gravador de disco. Este parâmetro pode ser NULL.
[out] pbstrProductID
Nome do produto do gravador de disco. Este parâmetro pode ser NULL.
[out] pbstrRevision
Revisão do gravador de disco. Normalmente, essa é a revisão do firmware do gravador, mas pode ser uma revisão para todo o dispositivo. Este parâmetro pode ser NULL.
Valor retornado
S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
Comentários
Os nomes de exibição normalmente são combinados em uma cadeia de caracteres que é exibida em caixas de listagem de seleção de gravador ou outros componentes da GUI.
A combinação dessas três cadeias de caracteres não produz um identificador exclusivo para esse gravador específico. Combine essas cadeias de caracteres com a cadeia de caracteres retornada de GetPath para criar um valor exclusivo.
Requisitos
| Cliente mínimo com suporte | Windows XP [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 | imapi.h |
| Biblioteca | Uuid.lib |
| DLL | Actxprxy.dll |