IKnownFolder::GetIDList-Methode (shobjidl_core.h)

Ruft den Speicherort des Shell-Namespaceordners im FORMULAR IDList (ITEMIDLIST) ab.

Syntax

HRESULT GetIDList(
  [in]  DWORD            dwFlags,
  [out] PIDLIST_ABSOLUTE *ppidl
);

Parameter

[in] dwFlags

Art: DWORD

Flags, die spezielle Abrufoptionen angeben. Dieser Wert kann 0 sein. andernfalls mindestens einer der KNOWN_FOLDER_FLAG Werte.

[out] ppidl

Typ: PIDLIST_ABSOLUTE*

Wenn diese Methode zurückgibt, enthält die Adresse einer absoluten PIDL. Dieser Parameter wird nicht initialisiert übergeben. Die aufrufende Anwendung ist für die Freigabe dieser Ressource verantwortlich, wenn sie nicht mehr benötigt wird.

Rückgabewert

Typ: HRESULT

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

Hinweise

Entspricht SHGetKnownFolderIDList.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)
DLL Shell32.dll

Weitere Informationen

IKnownFolder

Bekannte Ordner (Beispiel)

SHGetKnownFolderIDList