IKnownFolderManager::RegisterFolder-Methode (shobjidl_core.h)
Fügt der Registrierung einen neuen bekannten Ordner hinzu. Wird insbesondere von unabhängigen Softwareanbietern (ISVs) verwendet, die dem bekannten Ordnersystem einen ihrer eigenen Ordner hinzufügen.
Syntax
HRESULT RegisterFolder(
[in] REFKNOWNFOLDERID rfid,
[in] const KNOWNFOLDER_DEFINITION *pKFD
);
Parameter
[in] rfid
Typ: REFKNOWNFOLDERID
Eine GUID , die den bekannten Ordner darstellt.
[in] pKFD
Typ: const KNOWNFOLDER_DEFINITION*
Ein Zeiger auf eine gültige KNOWNFOLDER_DEFINITION-Struktur , die die Details des neuen Ordners bereitstellt.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Mehrere KNOWNFOLDERID-Werte für denselben Dateisystempfad können mehrere Probleme verursachen, z. B. Konflikte in der Desktop.ini-Datei, die zu Verwirrung darüber führen, welche Sprache oder Eigenschaften für den Ordner angezeigt werden sollen. Mehrere KNOWNFOLDERID-Werte können auch Verwirrung über den Adressleistenpfad oder die Aufgaben verursachen, die für den Ordner in Windows Explorer angezeigt werden sollen.
Sie können die Anzeige der Seite Anpassen der Eigenschaftenfenster Ihres bekannten Ordners unterdrücken. Legen Sie hierzu den folgenden Registrierungs-REG_DWORD Wert fest:
HKEY_LOCAL_MACHINE Software Microsoft Windows CurrentVersion Explorer FolderDescriptions Folder GUID PropertyBag NoCustomize = 0x00000001 (1)
Anforderungen
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 |