Método IBackgroundCopyFile2::SetRemoteName
Altera o nome remoto para uma nova URL em um trabalho de download.
Sintaxe
HRESULT SetRemoteName(
[in] LPCWSTR RemoteName
);
Parâmetros
-
RemoteName [in]
-
Cadeia de caracteres terminada em nulo que contém o nome do arquivo no servidor. Para obter informações sobre como especificar o nome remoto, consulte o membro RemoteName .
Valor retornado
Esse método retorna os seguintes valores retornados, bem como outros.
| Código de retorno | Descrição |
|---|---|
|
Êxito |
|
O novo nome remoto é uma URL inválida ou a nova URL é muito longa (a URL não pode exceder 2.200 caracteres). |
Comentários
Normalmente, você chama esse método se quiser alterar a URL usada para transferir o arquivo ou se quiser alterar o nome ou o caminho do arquivo.
Esse método não serializa quando retorna. Para serializar a alteração, suspenda o trabalho, chame esse método (se alterar vários arquivos no trabalho, use um loop) e retome o trabalho. Chamar o método IBackgroundCopyJob::Resume serializa a alteração.
Se o carimbo de data/hora ou o tamanho do arquivo do novo nome remoto for diferente do nome remoto anterior ou o novo servidor não oferecer suporte ao currículo de ponto de verificação (para nomes remotos HTTP), a Otimização de Entrega reiniciará o download. Caso contrário, a transferência será retomada da mesma posição no novo servidor. A Otimização de Entrega não reinicia arquivos já transferidos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 10, versão 1709 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server, versão 1709 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|
| Biblioteca |
|
| DLL |
|
| IID |
IID_IBackgroundCopyFile2 é definido como 83e81b93-0873-474d-8a8c-f2018b1a939c |