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

  • Artigo

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
E_INVALIDARG
 O valor pszFileName é definido como NULL, aponta para uma cadeia de caracteres vazia ou aponta para um nome de arquivo maior que MAX_PATH.
E_UNEXPECTED
 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)

Confira também

IAttachmentExecute

IAttachmentExecute::SetLocalPath