IKnownFolderManager::GetFolderIds-Methode (shobjidl_core.h)

  • Artikel

Ruft ein Array aller registrierten bekannten Ordner-IDs ab. Dies kann zum Auflisten aller bekannten Ordner verwendet werden.

Syntax

HRESULT GetFolderIds(
  [out]     KNOWNFOLDERID **ppKFId,
  [in, out] UINT          *pCount
);

Parameter

[out] ppKFId

Typ: KNOWNFOLDERID**

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein Array aller KNOWNFOLDERID-Werte , die beim System registriert sind. Verwenden Sie CoTaskMemFree , um diese Ressourcen freizugeben, wenn sie nicht mehr benötigt werden.

[in, out] pCount

Typ: UINT*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf die Anzahl der KNOWNFOLDERID-Werte im Array unter ppKFId. Die [in]-Funktionalität dieses Parameters wird nicht verwendet.

Rückgabewert

Typ: HRESULT

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

Hinweise

Der Aufrufer dieser Methode muss über Benutzerberechtigungen verfügen.

Sie können StringFromCLSID oder StringFromGUID2 verwenden, um die abgerufenen KNOWNFOLDERID-Werte in Zeichenfolgen zu konvertieren.

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)

Weitere Informationen

IKnownFolderManager

Bekannte Ordner (Beispiel)