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

Artículo
02/29/2024

El método GetName recupera el nombre para mostrar del objeto de almacenamiento.

Sintaxis

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

Parámetros

[out] pwszName

Puntero a una cadena terminada en null de caracteres anchos (Unicode) que contiene el nombre del objeto.

[in] nMaxChars

Entero que contiene el número máximo de caracteres que se pueden copiar en la cadena de nombre.

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 nombre para mostrar del objeto es el nombre de archivo sin información de ruta de acceso. En los medios jerárquicos, el nombre para mostrar se concatenaría con las instancias antecesoras de las interfaces IMDSPStorage para crear un nombre completo de ruta de acceso.

El tipo de cadena LPWSTR es una cadena de caracteres Unicode de 16 bits y no acepta caracteres de tamaño byte.

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.