Compartir a través de


Método IMDSPDevice2::GetCanonicalName (mswmdm.h)

El método GetCanonicalPName obtiene el nombre canónico de un dispositivo.

Sintaxis

HRESULT GetCanonicalName(
  [out] LPWSTR pwszPnPName,
  [in]  UINT   nMaxChars
);

Parámetros

[out] pwszPnPName

Carácter ancho, búfer terminado en null que contiene el nombre canónico. El autor de la llamada asigna y libera este búfer.

[in] nMaxChars

Entero que contiene el número máximo de caracteres que se pueden colocar en pwszCanonicalName, incluido el carácter de terminación.

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.

Comentarios

Este método devuelve un nombre canónico para el dispositivo. El proveedor de servicios debe devolver el nombre de la ruta de acceso del dispositivo como su nombre canónico. El proveedor de servicios se pasa el nombre de la ruta de acceso del dispositivo en el método CreateDevice en la interfaz IMDServiceProvider2 .

Esto es opcional. Para obtener más información, consulte Interfaces obligatorias y opcionales.

Requisitos

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

Consulte también

Interfaz IMDSPDevice2

Interfaz IMDServiceProvider2

IMDServiceProvider2::CreateDevice