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