Compartilhar via


Método IBackgroundCopyFile::GetRemoteName (bits.h)

Recupera o nome remoto do arquivo.

Sintaxe

HRESULT GetRemoteName(
  [out] LPWSTR *pVal
);

Parâmetros

[out] pVal

Cadeia de caracteres terminada em nulo que contém o nome remoto do arquivo a ser transferido. O nome é totalmente qualificado. Chame a função CoTaskMemFree para liberar ppName quando terminar.

Retornar valor

Esse método retorna S_OK em caso de êxito ou um dos valores COM HRESULT padrão em caso de erro.

Comentários

O nome do arquivo remoto é definido quando você chama os métodos AddFile ou AddFileSet da interface IBackgroundCopyJob .

Para alterar o nome do arquivo remoto, chame o método IBackgroundCopyFile2::SetRemoteName ou o método IBackgroundCopyJob3::ReplaceRemotePrefix .

Exemplos

Consulte o código de exemplo para o método IBackgroundCopyFile::GetLocalName .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Plataforma de Destino Windows
Cabeçalho bits.h
Biblioteca Bits.lib
DLL QmgrPrxy.dll

Confira também

IBackgroundCopyFile

IBackgroundCopyFile::GetLocalName

IBackgroundCopyJob::AddFile

IBackgroundCopyJob::AddFileSet