IKnownFolderManager::GetFolder-Methode (shobjidl_core.h)

Ruft ein -Objekt ab, das einen bekannten Ordner darstellt, der durch seine KNOWNFOLDERID identifiziert wird. Mit dem -Objekt können Sie bestimmte Ordnereigenschaften abfragen, den aktuellen Pfad des Ordners abrufen, den Ordner an einen anderen Speicherort umleiten und den Pfad des Ordners als ITEMIDLIST abrufen.

Syntax

HRESULT GetFolder(
  [in]  REFKNOWNFOLDERID rfid,
  [out] IKnownFolder     **ppkf
);

Parameter

[in] rfid

Typ: REFKNOWNFOLDERID

Verweis auf die KNOWNFOLDERID.

[out] ppkf

Typ: IKnownFolder**

Wenn diese Methode zurückgibt, enthält einen Schnittstellenzeiger auf das IKnownFolder-Objekt , das den Ordner darstellt.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück, einschließlich der folgenden:

Rückgabecode	Beschreibung
E_INVALIDARG	Dieser Wert kann unter anderem angeben, dass der rfid-Parameter auf eine KNOWNFOLDERID verweist, die nicht im System vorhanden ist. Nicht alle KNOWNFOLDERID-Werte sind auf allen Systemen vorhanden. Verwenden Sie IKnownFolderManager::GetFolderIds , um den Satz von KNOWNFOLDERID-Werten für das aktuelle System abzurufen.

Hinweise

Um diese Methode aufrufen zu können, muss der Aufrufer mindestens über Benutzerberechtigungen verfügen.

Verwendungs-Gründe

Verwenden Sie diese Methode, wenn Sie genau wissen, nach welchem bekannten Ordner Sie suchen und direkt darauf zugreifen möchten.

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 (shobjidl.h einschließen)
DLL	Shell32.dll

Weitere Informationen

IKnownFolderManager

Bekannte Ordner (Beispiel)