SHGetNameFromIDList-Funktion (shobjidl_core.h)

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

Syntax

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

Die Parameter

[in] pidl

Typ: PCIDLIST_ABSOLUTE

Eine PIDL, die das Element identifiziert.

[in] sigdnName

Typ: SIGDN

Ein Wert aus der SIGDN-Aufzählung , der den Typ des abzurufenden Anzeigenamens angibt.

[out] ppszName

Typ: PWSTR*

Ein Wert, der, wenn diese Funktion erfolgreich zurückgegeben wird, 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 HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Es liegt in der Verantwortung des Aufrufers, die Zeichenfolge zu befreien, auf die ppszName verweist, wenn sie nicht mehr benötigt wird. Rufen Sie CoTaskMemFree auf *ppszName auf, um den Speicher freizugeben.

Anforderungen