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) |