SHGetNameFromIDList-Funktion (shobjidl_core.h)

Ruft den Anzeigenamen eines Elements ab, das durch seine IDList identifiziert wird.

Syntax

SHSTDAPI SHGetNameFromIDList(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  SIGDN             sigdnName,
  [out] PWSTR             *ppszName
);

Parameter

[in] pidl

Typ: PCIDLIST_ABSOLUTE

Eine PIDL, die das Element identifiziert.

[in] sigdnName

Typ: SIGDN

Ein Wert aus der SIGDN-Enumeration , der den Typ des abzurufenden Anzeigenamens angibt.

[out] ppszName

Typ: PWSTR*

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

Rückgabewert

Typ: HRESULT

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

Hinweise

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

Anforderungen