Método IAttachmentExecute::SetFileName (shobjidl_core.h)
Especifica e armazena o nome proposto do arquivo.
Sintaxe
HRESULT SetFileName(
[in] LPCWSTR pszFileName
);
Parâmetros
[in] pszFileName
Tipo: LPCWSTR
Um ponteiro para uma cadeia de caracteres que contém o nome do arquivo.
Valor retornado
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT , incluindo o seguinte.
| Código de retorno | Descrição |
|---|---|
|
O valor pszFileName é definido como NULL, aponta para uma cadeia de caracteres vazia ou aponta para um nome de arquivo maior que MAX_PATH. |
|
O nome do arquivo não pode ser armazenado. |
Comentários
Nenhuma informação de caminho deve ser incluída em pszFileName, apenas no nome do arquivo.
IAttachmentExecute::SetFileName pode ser usado pelo aplicativo de chamada para marcar a validade do nome do arquivo antes de copiar o arquivo localmente. O nome do arquivo é verificado quanto a colisões de nome em relação a outros arquivos armazenados no local do caminho.
IAttachmentExecute::SetFileName é opcional.
Requisitos
| Cliente mínimo com suporte | Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shobjidl_core.h (inclua Shobjidl.h) |
| DLL | Shdocvw.dll (versão 6.0 ou posterior) |