Fonction SHCreateItemInKnownFolder (shobjidl_core.h)

Crée un objet d’élément Shell pour un fichier unique qui existe à l’intérieur d’un dossier connu.

Syntaxe

SHSTDAPI SHCreateItemInKnownFolder(
  [in]           REFKNOWNFOLDERID kfid,
                 DWORD            dwKFFlags,
  [in, optional] PCWSTR           pszItem,
  [in]           REFIID           riid,
  [out]          void             **ppv
);

Paramètres

[in] kfid

Type : REFKNOWNFOLDERID

Référence au KNOWNFOLDERID, un GUID qui identifie le dossier qui contient l’élément.

dwKFFlags

Type : DWORD

Indicateurs qui spécifient des options spéciales dans la récupération d’objets. Cette valeur peut être 0 ; sinon, une ou plusieurs des valeurs KNOWN_FOLDER_FLAG .

[in, optional] pszItem

Type : PCWSTR

Pointeur vers une mémoire tampon terminée par null qui contient le nom de fichier du nouvel élément sous la forme d’une chaîne Unicode. Ce paramètre peut également avoir la valeur NULL. Dans ce cas, un IShellItem qui représente le dossier connu lui-même est créé.

[in] riid

Type : REFIID

Référence à l’IID de l’interface qui représente l’élément, récupéré via ppv. Cette valeur est généralement IID_IShellItem ou IID_IShellItem2.

[out] ppv

Type : void**

Lorsque cette fonction retourne correctement, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’IShellItem ou IShellItem2.

Valeur retournée

Type : HRESULT

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

Spécifications

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
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-0 (introduit dans Windows 8.1)

Voir aussi

Dossiers connus, exemple