IKnownFolderManager::RegisterFolder-Methode (shobjidl_core.h)

  • Artikel

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

Hinweis Diese Methode aktualisiert HKEY_LOCAL_MACHINE und muss daher im Kontext eines Administrators ausgeführt werden. Setupprogramme benötigen Administratorrechte, um einen bekannten Ordner zu registrieren oder aufzuheben.
 
IKnownFolderManager::RegisterFolder versucht zu überprüfen, ob die neue KNOWNFOLDERID nicht auf einen Dateisystempfad verweist, auf den bereits eine vorhandene KNOWNFOLDERID verweist. Wenn die neue KNOWNFOLDERID dafür gefunden wird, schlägt diese Methode fehl.

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

Weitere Informationen

IKnownFolderManager

IKnownFolderManager::UnregisterFolder

Bekannte Ordner (Beispiel)