Condividi tramite

Metodo IFileOperationProgressSink::P ostNewItem (shobjidl_core.h)

  • Articolo

Esegue azioni implementate dal chiamante dopo la creazione del nuovo elemento.

Sintassi

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

Parametri

[in] dwFlags

Tipo: DWORD

valore bit per bit contenente flag usati durante l'operazione di creazione. Alcuni valori possono essere impostati o modificati durante l'operazione di creazione. Vedere TRANSFER_SOURCE_FLAGS per le descrizioni dei flag.

[in] psiDestinationFolder

Tipo: IShellItem*

Puntatore a un oggetto IShellItem che specifica la cartella di destinazione a cui è stato aggiunto il nuovo elemento.

[in] pszNewName

Tipo: LPCWSTR

Puntatore al nome del file del nuovo elemento, ad esempio Newfile.txt. Si tratta di una stringa Unicode con terminazione Null.

[in] pszTemplateName

Tipo: LPCWSTR

Puntatore al nome del file modello ,ad esempio Excel9.xls) in base al quale il nuovo elemento è basato, archiviato in una delle posizioni seguenti:

  • CSIDL_COMMON_TEMPLATES. Il percorso predefinito per questa cartella è %ALLUSERSPROFILE%\Templates.
  • CSIDL_TEMPLATES. Il percorso predefinito per questa cartella è %USERPROFILE%\Templates.
  • %SystemRoot%\shellnew
Si tratta di una stringa Unicode con terminazione null usata per specificare un file esistente dello stesso tipo del nuovo file, contenente il contenuto minimo che un'applicazione vuole includere in qualsiasi nuovo file.

Questo parametro è normalmente NULL per specificare un nuovo file vuoto.

[in] dwFileAttributes

Tipo: DWORD

Attributi di file applicati al nuovo elemento. Uno o più dei valori trovati in GetFileAttributes.

[in] hrNew

Tipo: HRESULT

Valore restituito dell'operazione di creazione. Si noti che non è il valore HRESULT restituito da NewItem, che accoda semplicemente l'operazione di creazione. Questo è invece il risultato della creazione effettiva.

[in] psiNewItem

Tipo: IShellItem*

Puntatore a un oggetto IShellItem che rappresenta il nuovo elemento.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario. Nel caso di un valore di errore, tutte le operazioni successive in sospeso dalla chiamata a IFileOperation vengono annullate.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)