IAttachmentExecute::SetFileName-Methode (shobjidl_core.h)

Gibt den vorgeschlagenen Namen der Datei an und speichert diese.

Syntax

HRESULT SetFileName(
  [in] LPCWSTR pszFileName
);

Parameter

[in] pszFileName

Typ: LPCWSTR

Ein Zeiger auf eine Zeichenfolge, die den Dateinamen enthält.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben, einschließlich des folgenden.

Rückgabecode Beschreibung
E_INVALIDARG
Der Wert pszFileName ist auf NULL festgelegt, zeigt auf eine leere Zeichenfolge oder zeigt auf einen Dateinamen, der länger als MAX_PATH ist.
E_UNEXPECTED
Der Dateiname kann nicht gespeichert werden.

Hinweise

Unter pszFileName sollten keine Pfadinformationen enthalten sein, nur der Name der Datei.

IAttachmentExecute::SetFileName kann von der aufrufenden Anwendung verwendet werden, um die Gültigkeit des Dateinamens zu überprüfen, bevor die Datei lokal kopiert wird. Der Dateiname wird auf Namenskonflikte mit anderen Dateien überprüft, die am speicherort des lokalen Pfads gespeichert sind.

IAttachmentExecute::SetFileName ist optional.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)
DLL Shdocvw.dll (Version 6.0 oder höher)

Weitere Informationen

IAttachmentExecute

IAttachmentExecute::SetLocalPath