IFileOperationProgressSink::P ostNewItem-Methode (shobjidl_core.h)

Artikel
08/26/2023

Führt vom Aufrufer implementierte Aktionen aus, nachdem das neue Element erstellt wurde.

Syntax

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

Parameter

[in] dwFlags

Art: DWORD

bitweiser Wert, der Flags enthält, die während des Erstellungsvorgangs verwendet wurden. Einige Werte können während des Erstellungsvorgangs festgelegt oder geändert werden. Flagbeschreibungen finden Sie unter TRANSFER_SOURCE_FLAGS .

[in] psiDestinationFolder

Typ: IShellItem*

Zeiger auf ein IShellItem,das den Zielordner angibt, dem das neue Element hinzugefügt wurde.

[in] pszNewName

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] dwFileAttributes

Art: DWORD

Die Dateiattribute, die auf das neue Element angewendet werden. Mindestens einer der Werte, die unter GetFileAttributes gefunden werden.

[in] hrNew

Typ: HRESULT

Der Rückgabewert des Erstellungsvorgangs. Beachten Sie, dass dies nicht das von NewItem zurückgegebene HRESULT ist, das einfach den Erstellungsvorgang in die Warteschlange stellt. Stattdessen ist dies das Ergebnis der tatsächlichen Erstellung.

[in] psiNewItem

Typ: IShellItem*

Zeiger auf ein IShellItem , das das neue Element darstellt.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Im Fall eines Fehlerwerts werden alle nachfolgenden Vorgänge abgebrochen, die vom Aufruf von IFileOperation ausstehen.

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)