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

Obtient la valeur CSIDL héritée qui est l’équivalent d’un KNOWNFOLDERID donné.

Syntaxe

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

Paramètres

[in] rfid

Type : REFKNOWNFOLDERID

Référence au KNOWNFOLDERID.

[out] pnCsidl

Type : int*

Lorsque cette méthode retourne, contient un pointeur vers la valeur CSIDL . Ce pointeur est passé non initialisé.

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 de valeurs KNOWNFOLDERID pour le système actuel.

Remarques

Pour appeler cette méthode, l’appelant doit disposer d’au moins des privilèges utilisateur.

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 ::FolderIdFromCsidl

Dossiers connus, exemple