IFileOperation ::NewItem, méthode (shobjidl_core.h)

Article
08/26/2023

Déclare un élément qui doit être créé à un emplacement spécifié.

Syntaxe

HRESULT NewItem(
  [in] IShellItem                 *psiDestinationFolder,
  [in] DWORD                      dwFileAttributes,
  [in] LPCWSTR                    pszName,
  [in] LPCWSTR                    pszTemplateName,
  [in] IFileOperationProgressSink *pfopsItem
);

Paramètres

[in] psiDestinationFolder

Type : IShellItem*

Pointeur vers un IShellItem qui spécifie le dossier de destination qui contiendra le nouvel élément.

[in] dwFileAttributes

Type : DWORD

Valeur au niveau du bit qui spécifie les attributs du système de fichiers pour le fichier ou le dossier. Consultez GetFileAttributes pour connaître les valeurs possibles.

[in] pszName

Type : LPCWSTR

Pointeur vers le nom de fichier du nouvel élément, pour instance Newfile.txt. Il s’agit d’une chaîne Unicode terminée par un caractère Null.

[in] pszTemplateName

Type : LPCWSTR

Pointeur vers le nom du fichier de modèle (par exemple ,Excel9.xls) sur lequel le nouvel élément est basé, stocké dans l’un des emplacements suivants :

CSIDL_COMMON_TEMPLATES. Le chemin d’accès par défaut de ce dossier est %ALLUSERSPROFILE%\Templates.
CSIDL_TEMPLATES. Le chemin d’accès par défaut de ce dossier est %USERPROFILE%\Templates.
%SystemRoot%\shellnew

Il s’agit d’une chaîne Unicode terminée par null utilisée pour spécifier un fichier existant du même type que le nouveau fichier, contenant le contenu minimal qu’une application souhaite inclure dans n’importe quel nouveau fichier.

Ce paramètre est normalement NULL pour spécifier un nouveau fichier vide.

[in] pfopsItem

Type : IFileOperationProgressSink*

Pointeur vers un objet IFileOperationProgressSink à utiliser pour les notifications de status et d’échec. Si vous appelez IFileOperation ::Advise pour l’opération globale, la progression status et les notifications d’erreur pour l’opération de création y sont incluses. Définissez donc ce paramètre sur NULL.

Valeur retournée

Type : HRESULT

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

Remarques

Cette méthode ne crée pas l’élément, mais déclare simplement l’élément à créer. Pour créer un élément, vous devez effectuer au moins la séquence d’appels détaillée ici :

Appelez IFileOperation ::NewItem pour déclarer les spécificités du nouveau fichier ou dossier.
Appelez IFileOperation ::P erformOperations pour créer l’élément.

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 (incluez Shobjidl.h)

Voir aussi

IFileOperation

PostNewItem

PreNewItem

Partager via