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

El método GetDeviceFromCanonicalName recupera una interfaz IWMDMDevice para un dispositivo con un nombre canónico especificado. Puede recuperar el nombre canónico de un dispositivo llamando a IWMDMDevice2::GetCanonicalName.

Sintaxis

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

Parámetros

pwszCanonicalName

Cadena terminada en caracteres anchos y terminada en NULL que especifica el nombre canónico del dispositivo.

ppDevice

Puntero a un puntero a la interfaz IWMDMDevice del objeto de dispositivo con el nombre canónico especificado. El autor de la llamada debe liberar esta interfaz cuando haya terminado con ella.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
E_INVALIDARG	El parámetro pwszCanonicalName o ppDeviceArray es un puntero no válido o NULL .
S_FALSE	No se encuentra ningún dispositivo conectado con el nombre canónico pwszCanonicalName.

Comentarios

Este método puede ser útil si una aplicación implementa IWMDMNotification, que envía una notificación de nombre canónico cuando un dispositivo se conecta o se desconecta del equipo.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	mswmdm.h
Library	Mssachlp.lib

Consulte también

IWMDMDevice2 (Interfaz)

Interfaz IWMDeviceManager2