IShellItem::GetDisplayName-Methode (shobjidl_core.h)

  • Artikel

Ruft den Anzeigenamen des IShellItem-Objekts ab.

Syntax

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

Parameter

[in] sigdnName

Typ: SIGDN

Einer der SIGDN-Werte , der angibt, wie der Name aussehen soll.

[out] ppszName

Typ: LPWSTR*

Ein Wert, der bei erfolgreicher Rückgabe dieser Funktion die Adresse eines Zeigers auf den abgerufenen Anzeigenamen empfängt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Es liegt in der Verantwortung des Aufrufers, die von ppszName angegebene Zeichenfolge frei zu geben, wenn sie nicht mehr benötigt wird. Rufen Sie CoTaskMemFree auf *ppszName auf, um den Arbeitsspeicher freizugeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shlguid.h)
DLL Shell32.dll (Version 5.00 oder höher)

Weitere Informationen

IShellFolder

IShellItem