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

  • Artikel

Führt vom Aufrufer implementierte Aktionen aus, bevor der Prozess zum Erstellen eines neuen Elements beginnt.

Syntax

HRESULT PreNewItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName
);

Parameter

[in] dwFlags

Art: DWORD

bitweiser Wert, der Flags enthält, die den Vorgang steuern. Flagbeschreibungen finden Sie unter TRANSFER_SOURCE_FLAGS .

[in] psiDestinationFolder

Typ: IShellItem*

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

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

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Im Fall eines Fehlerwerts werden dieser Vorgang und alle nachfolgenden Vorgänge abgebrochen, die ab dem 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)