Método IShellItem::GetDisplayName (shobjidl_core.h)

Obtiene el nombre para mostrar del objeto IShellItem .

Sintaxis

HRESULT GetDisplayName(
  [in]  SIGDN  sigdnName,
  [out] LPWSTR *ppszName
);

Parámetros

[in] sigdnName

Tipo: SIGDN

Uno de los valores de SIGDN que indica cómo debe tener el nombre.

[out] ppszName

Tipo: LPWSTR*

Valor que, cuando esta función devuelve correctamente, recibe la dirección de un puntero al nombre para mostrar recuperado.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Es responsabilidad del autor de la llamada liberar la cadena a la que apunta ppszName cuando ya no es necesaria. Llame a CoTaskMemFree en *ppszName para liberar la memoria.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (incluya Shlguid.h)
Archivo DLL	Shell32.dll (versión 5.00 o posterior)

Consulte también

IShellFolder

IShellItem