IKnownFolderManager ::UnregisterFolder, méthode (shobjidl_core.h)

  • Article

Supprimez un dossier connu du Registre, ce qui le rend inconnu du système de dossiers connu. Cette méthode ne supprime pas le dossier lui-même.

Syntaxe

HRESULT UnregisterFolder(
  [in] REFKNOWNFOLDERID rfid
);

Paramètres

[in] rfid

Type : REFKNOWNFOLDERID

GUID ou KNOWNFOLDERID qui représente le dossier connu.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire, y compris les éléments suivants :

Code de retour Description
E_INVALIDARG
 Entre autres, cette valeur peut indiquer que le paramètre rfid fait référence à un KNOWNFOLDERID qui n’est pas présent sur le système. Toutes les valeurs KNOWNFOLDERID ne sont pas présentes sur tous les systèmes. Utilisez IKnownFolderManager ::GetFolderIds pour récupérer l’ensemble des valeurs KNOWNFOLDERID connues du système actuel.

Remarques

Note Cette méthode met à jour HKEY_LOCAL_MACHINE et doit ê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.
 

Configuration requise

Condition requise Valeur
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 (inclure Shobjidl.h)
DLL Shell32.dll

Voir aussi

IKnownFolderManager

IKnownFolderManager ::RegisterFolder

Dossiers connus, exemple