IFileOperation::NewItem-Methode (shobjidl_core.h)

Artikel
03/02/2024

Deklariert ein neues Element, das an einem angegebenen Speicherort erstellt werden soll.

Syntax

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

Parameter

[in] psiDestinationFolder

Typ: IShellItem*

Zeiger auf ein IShellItem, das den Zielordner angibt, der das neue Element enthält.

[in] dwFileAttributes

Art: DWORD

Ein bitweiser Wert, der die Dateisystemattribute für die Datei oder den Ordner angibt. Mögliche Werte finden Sie unter GetFileAttributes .

[in] pszName

Typ: LPCWSTR

Zeiger auf den Dateinamen des neuen Elements für instance Newfile.txt. Hierbei handelt es sich um eine Unicode-Zeichenfolge mit Null-Beendigung.

[in] pszTemplateName

Typ: LPCWSTR

Zeiger auf den Namen der Vorlagendatei (z. B.Excel9.xls), auf der das neue Element basiert, wird an einem der folgenden Speicherorte gespeichert:

CSIDL_COMMON_TEMPLATES. Der Standardpfad für diesen Ordner ist %ALLUSERSPROFILE%\Templates.
CSIDL_TEMPLATES. Der Standardpfad für diesen Ordner ist %USERPROFILE%\Templates.
%SystemRoot%\shellnew

Hierbei handelt es sich um eine Unicode-Zeichenfolge mit Null-Beendigung, die verwendet wird, um eine vorhandene Datei desselben Typs wie die neue Datei anzugeben, die den minimalen Inhalt enthält, den eine Anwendung in jede neue Datei einschließen möchte.

Dieser Parameter ist normalerweise NULL , um eine neue, leere Datei anzugeben.

[in] pfopsItem

Typ: IFileOperationProgressSink*

Zeiger auf ein IFileOperationProgressSink-Objekt, das für status- und Fehlerbenachrichtigungen verwendet werden soll. Wenn Sie IFileOperation::Advise für den Gesamtvorgang aufrufen, sind dort fortschritts- status und Fehlerbenachrichtigungen für den Erstellungsvorgang enthalten. Legen Sie also diesen Parameter auf NULL fest.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode erstellt das neue Element nicht, sondern deklariert lediglich das zu erstellende Element. Um ein neues Element zu erstellen, müssen Sie mindestens die hier beschriebene Reihenfolge der Aufrufe ausführen:

Rufen Sie IFileOperation::NewItem auf , um die Besonderheiten der neuen Datei oder des neuen Ordners zu deklarieren.
Rufen Sie IFileOperation::P erformOperations auf , um das neue Element zu erstellen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Weitere Informationen

IFileOperation

PostNewItem

PreNewItem

Freigeben über