Metodo IFileOperation::NewItem (shobjidl_core.h)

Articolo
08/26/2023

Dichiara un nuovo elemento da creare in una posizione specificata.

Sintassi

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

Parametri

[in] psiDestinationFolder

Tipo: IShellItem*

Puntatore a un oggetto IShellItem che specifica la cartella di destinazione che conterrà il nuovo elemento.

[in] dwFileAttributes

Tipo: DWORD

Valore bit per bit che specifica gli attributi del file system per il file o la cartella. Per i valori possibili, vedere GetFileAttributes .

[in] pszName

Tipo: LPCWSTR

Puntatore al nome file del nuovo elemento, ad esempio Newfile.txt. Stringa Unicode con terminazione Null.

[in] pszTemplateName

Tipo: LPCWSTR

Puntatore al nome del file modello (ad esempio Excel9.xls) su cui si basa il nuovo elemento, archiviato in uno dei percorsi 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 è in genere NULL per specificare un nuovo file vuoto.

[in] pfopsItem

Tipo: IFileOperationProgressSink*

Puntatore a un oggetto IFileOperationProgressSink da usare per le notifiche di stato e di errore. Se si chiama IFileOperation::Advise per l'operazione complessiva, sono incluse le notifiche relative allo stato di avanzamento e agli errori per l'operazione di creazione, quindi impostare questo parametro su NULL.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo non crea il nuovo elemento, ma dichiara semplicemente l'elemento da creare. Per creare un nuovo elemento, è necessario effettuare almeno la sequenza di chiamate descritte di seguito:

Chiamare IFileOperation::NewItem per dichiarare le specifiche del nuovo file o cartella.
Chiamare IFileOperation::P erformOperations per creare il nuovo elemento.

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)

Vedi anche

IFileOperation

PostNewItem

PreNewItem

Condividi tramite