SHCreateItemInKnownFolder, fonction (shobjidl_core.h)

Crée un objet d’élément Shell pour un seul fichier 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, 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’objet. Cette valeur peut être 0 ; sinon, une ou plusieurs 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 forme de chaîne Unicode. Ce paramètre peut également être 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

Voir aussi

Exemple de dossiers connus