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 |
|---|---|
|
Der Wert pszFileName ist auf NULL festgelegt, zeigt auf eine leere Zeichenfolge oder zeigt auf einen Dateinamen, der länger als MAX_PATH ist. |
|
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) |