Método IAttachmentExecute::SetFileName (shobjidl_core.h)

Especifica y almacena el nombre propuesto del archivo.

Sintaxis

HRESULT SetFileName(
  [in] LPCWSTR pszFileName
);

Parámetros

[in] pszFileName

Tipo: LPCWSTR

Puntero a una cadena que contiene el nombre de archivo.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT , incluido lo siguiente.

Código devuelto	Descripción
E_INVALIDARG	El valor pszFileName se establece en NULL, apunta a una cadena vacía o apunta a un nombre de archivo más largo que MAX_PATH.
E_UNEXPECTED	No se puede almacenar el nombre de archivo.

Comentarios

No se debe incluir información de ruta de acceso en pszFileName, solo el nombre del archivo.

La aplicación que realiza la llamada puede usar IAttachmentExecute::SetFileName para comprobar la validez del nombre de archivo antes de copiar el archivo localmente. El nombre de archivo se comprueba si hay colisiones de nombres con otros archivos almacenados en la ubicación de la ruta de acceso local.

IAttachmentExecute::SetFileName es opcional.

Requisitos

Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (incluya Shobjidl.h)
Archivo DLL	Shdocvw.dll (versión 6.0 o posterior)

Consulte también

IAttachmentExecute

IAttachmentExecute::SetLocalPath