Compartilhar via

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

  • Artigo

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