Método IWMDeviceManager2::GetDeviceFromCanonicalName (mswmdm.h)

O método GetDeviceFromCanonicalName recupera uma interface IWMDMDevice para um dispositivo com um nome canônico especificado. Você pode recuperar o nome canônico de um dispositivo chamando IWMDMDevice2::GetCanonicalName.

Sintaxe

HRESULT GetDeviceFromCanonicalName(
  LPCWSTR     pwszCanonicalName,
  IWMDMDevice **ppDevice
);

Parâmetros

pwszCanonicalName

Uma cadeia de caracteres largos terminada em nulo especificando o nome canônico do dispositivo.

ppDevice

Ponteiro para um ponteiro para a interface IWMDMDevice do objeto do dispositivo com o nome canônico especificado. O chamador deve liberar essa interface quando terminar com ela.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
E_INVALIDARG	O parâmetro pwszCanonicalName ou ppDeviceArray é um ponteiro NULL ou inválido.
S_FALSE	Não há nenhum dispositivo conectado encontrado com o nome canônico pwszCanonicalName.

Comentários

Esse método poderá ser útil se um aplicativo implementar IWMDMNotification, que envia uma notificação de nome canônico quando um dispositivo se conecta ou se desconecta do computador.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	mswmdm.h
Biblioteca	Mssachlp.lib

Confira também

IWMDMDevice2 Interface

IWMDeviceManager2 Interface