IKnownFolderManager::FolderIdToCsidl-Methode (shobjidl_core.h)

Ruft den Legacy-CSIDL-Wert ab, der einer bestimmten KNOWNFOLDERID entspricht.

Syntax

HRESULT FolderIdToCsidl(
  [in]  REFKNOWNFOLDERID rfid,
  [out] int              *pnCsidl
);

Parameter

[in] rfid

Typ: REFKNOWNFOLDERID

Verweis auf die KNOWNFOLDERID.

[out] pnCsidl

Typ: int*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf den CSIDL-Wert . Dieser Zeiger wird nicht initialisiert übergeben.

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.

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

IKnownFolderManager::FolderIdFromCsidl

Bekannte Ordner (Beispiel)