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

  • Article

Obtient un tableau de tous les ID de dossier connus inscrits. Cela peut être utilisé dans l’énumération de tous les dossiers connus.

Syntaxe

HRESULT GetFolderIds(
  [out]     KNOWNFOLDERID **ppKFId,
  [in, out] UINT          *pCount
);

Paramètres

[out] ppKFId

Type : KNOWNFOLDERID**

Lorsque cette méthode retourne, contient un pointeur vers un tableau de toutes les valeurs KNOWNFOLDERID inscrites auprès du système. Utilisez CoTaskMemFree pour libérer ces ressources lorsqu’elles ne sont plus nécessaires.

[in, out] pCount

Type : UINT*

Lorsque cette méthode retourne, contient un pointeur vers le nombre de valeurs KNOWNFOLDERID dans le tableau à ppKFId. La fonctionnalité [in] de ce paramètre n’est pas utilisée.

Valeur retournée

Type : HRESULT

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

Remarques

L’appelant de cette méthode doit disposer de privilèges d’utilisateur.

Vous pouvez utiliser StringFromCLSID ou StringFromGUID2 pour convertir les valeurs KNOWNFOLDERID récupérées en chaînes.

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)

Voir aussi

IKnownFolderManager

Dossiers connus, exemple