Partager via

Méthode IFileOperationProgressSink ::P ostNewItem (shobjidl_core.h)

  • Article

Effectue des actions implémentées par l’appelant après la création du nouvel élément.

Syntaxe

HRESULT PostNewItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName,
  [in] LPCWSTR    pszTemplateName,
  [in] DWORD      dwFileAttributes,
  [in] HRESULT    hrNew,
  [in] IShellItem *psiNewItem
);

Paramètres

[in] dwFlags

Type : DWORD

valeur au niveau du bit qui contient les indicateurs utilisés pendant l’opération de création. Certaines valeurs peuvent être définies ou modifiées pendant l’opération de création. Consultez TRANSFER_SOURCE_FLAGS pour obtenir des descriptions d’indicateur.

[in] psiDestinationFolder

Type : IShellItem*

Pointeur vers un objet IShellItem qui spécifie le dossier de destination auquel le nouvel élément a été ajouté.

[in] pszNewName

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 null.

[in] pszTemplateName

Type : LPCWSTR

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

  • CSIDL_COMMON_TEMPLATES. Le chemin 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 tout nouveau fichier.

Ce paramètre a normalement la valeur NULL pour spécifier un nouveau fichier vide.

[in] dwFileAttributes

Type : DWORD

Attributs de fichier appliqués au nouvel élément. Une ou plusieurs des valeurs trouvées dans GetFileAttributes.

[in] hrNew

Type : HRESULT

Valeur de retour de l’opération de création. Notez qu’il ne s’agit pas du HRESULT retourné par NewItem, qui met simplement en file d’attente l’opération de création. Au lieu de cela, il s’agit du résultat de la création réelle.

[in] psiNewItem

Type : IShellItem*

Pointeur vers un IShellItem qui représente le nouvel élément.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire. En cas de valeur d’erreur, toutes les opérations suivantes en attente de l’appel à IFileOperation sont annulées.

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)