IKnownFolderManager::GetFolderIds-Methode (shobjidl_core.h)
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) |