Método IMDSPDevice::GetName (mswmdm.h)

  • Artículo

El método GetName recupera el nombre del dispositivo.

Sintaxis

HRESULT GetName(
  [out] LPWSTR pwszName,
  [in]  UINT   nMaxChars
);

Parámetros

[out] pwszName

Puntero a una matriz de caracteres Unicode de 16 bits que recibe la cadena de nombre del dispositivo.

[in] nMaxChars

Número máximo de caracteres que se van a copiar en la cadena.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

  • Códigos de error COM estándar
  • Códigos de error de Windows convertidos en valores HRESULT
  • Códigos de error de windows Media Administrador de dispositivos
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

El tipo de cadena LPWSTR es una cadena de caracteres Unicode de 16 bits y no acepta caracteres de tamaño byte. Para convertir una cadena de caracteres de tamaño de bytes (LPCSTR) en una cadena LPWSTR , use la función MultiByteToWideChar como se describe en la documentación de Microsoft Windows.

Los nombres de dispositivo no deben contener espacios finales.

Este método debe implementarse. No debe devolver WMDM_E_NOTSUPPORTED ni E_NOTIMPL. 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 IMDSPDevice

IMDSPDevice::GetType