Méthode IKnownFolderManager::RegisterFolder (shobjidl_core.h)

Ajoute un nouveau dossier connu au Registre. Utilisé en particulier par les éditeurs de logiciels indépendants qui ajoutent l’un de leurs propres dossiers au système de dossiers connus.

Syntaxe

HRESULT RegisterFolder(
  [in] REFKNOWNFOLDERID             rfid,
  [in] const KNOWNFOLDER_DEFINITION *pKFD
);

Paramètres

[in] rfid

Type : REFKNOWNFOLDERID

GUID qui représente le dossier connu.

[in] pKFD

Type : const KNOWNFOLDER_DEFINITION*

Pointeur vers une structure KNOWNFOLDER_DEFINITION valide qui fournit les détails du nouveau dossier.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Note Cette méthode met à jour HKEY_LOCAL_MACHINE et doit donc être exécutée dans le contexte d’un administrateur. Les programmes d’installation ont besoin de privilèges d’administrateur pour inscrire ou annuler l’inscription d’un dossier connu.

 

IKnownFolderManager::RegisterFolder tente de vérifier que le nouveau KNOWNFOLDERID ne fait pas référence à un chemin de système de fichiers déjà pointé par un KNOWNFOLDERID existant. Si le nouveau KNOWNFOLDERID est trouvé pour le faire, cette méthode échoue.

Plusieurs valeurs KNOWNFOLDERID pour le même chemin de système de fichiers peuvent entraîner plusieurs problèmes, tels que des conflits dans le fichier Desktop.ini qui entraînent une confusion quant à la langue ou aux propriétés à afficher pour le dossier. Plusieurs valeurs KNOWNFOLDERID peuvent également entraîner une confusion quant au chemin d’accès de la barre d’adresse ou aux tâches à afficher pour le dossier dans Windows Explorer.

Vous pouvez supprimer l’affichage de la page Personnaliser des Fenêtre Propriétés de votre dossier connu. Pour ce faire, définissez la valeur de REG_DWORD de Registre suivante :

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Explorer
                  FolderDescriptions
                     Folder GUID
                        PropertyBag
                           NoCustomize = 0x00000001 (1)

Configuration requise

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll

Voir aussi

IKnownFolderManager

IKnownFolderManager::UnregisterFolder

Dossiers connus, exemple