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 |