Método IBackgroundCopyJob::SetProxySettings (bits.h)

Especifica qual proxy usar para transferir arquivos.

Sintaxe

HRESULT SetProxySettings(
  [in] BG_JOB_PROXY_USAGE ProxyUsage,
  [in] const WCHAR        *ProxyList,
  [in] const WCHAR        *ProxyBypassList
);

Parâmetros

[in] ProxyUsage

Especifica se as configurações de proxy do usuário devem ser usadas, não para usar um proxy ou para usar as configurações de proxy especificadas pelo aplicativo. O padrão é usar as configurações de proxy do usuário, BG_JOB_PROXY_USAGE_PRECONFIG. Para obter uma lista de opções de proxy, consulte a enumeração BG_JOB_PROXY_USAGE .

[in] ProxyList

Cadeia de caracteres terminada em nulo que contém os proxies a serem usados para transferir arquivos. A lista é delimitada por espaço. Para obter detalhes sobre como especificar um proxy, consulte Comentários.

Esse parâmetro deverá ser NULL se o valor de ProxyUsage for BG_JOB_PROXY_USAGE_PRECONFIG, BG_JOB_PROXY_USAGE_NO_PROXY ou BG_JOB_PROXY_USAGE_AUTODETECT.

O comprimento da lista de proxy é limitado a 4.000 caracteres, não incluindo o terminador nulo.

[in] ProxyBypassList

Cadeia de caracteres terminada em nulo que contém uma lista opcional de nomes de host, endereços IP ou ambos, que podem ignorar o proxy. A lista é delimitada por espaço. Para obter detalhes sobre como especificar um proxy de bypass, consulte Comentários.

Esse parâmetro deverá ser NULL se o valor de ProxyUsage for BG_JOB_PROXY_USAGE_PRECONFIG, BG_JOB_PROXY_USAGE_NO_PROXY ou BG_JOB_PROXY_USAGE_AUTODETECT.

O comprimento da lista de bypass de proxy é limitado a 4.000 caracteres, sem incluir o terminador nulo.

Retornar valor

Esse método retorna os seguintes valores HRESULT , bem como outros.

Comentários

As informações de proxy fornecidas são validadas em tempo de execução. Se as informações de proxy forem inválidas, o trabalho entrará no estado BG_JOB_STATE_ERROR com um código de erro BG_E_INVALID_PROXY_INFO .

Se o serviço for executado como LocalSystem, você deverá usar o método SetProxySettings para especificar explicitamente uma lista de bypass de proxy ou proxy para a conta e definir ProxyUsage como BG_JOB_PROXY_USAGE_OVERRIDE. Para obter mais informações sobre como usar contas do sistema com BITS, consulte Contas de serviço e BITS.

O BITS não reconhece as configurações de proxy definidas usando o arquivo Proxycfg.exe.

Especifique um proxy como:

"[protocol=][protocol"://"]server[":"port]"

Os protocolos válidos são HTTP e HTTPS. A lista de proxy pode conter o número da porta usado para acessar o proxy. Por exemplo, para listar um proxy HTTP, uma cadeia de caracteres válida é "http=http://http_proxy_name:80", em que http_proxy_name é o nome do servidor proxy e 80 é o número de porta que você deve usar para acessar o proxy. Se o proxy usar o número da porta padrão para esse protocolo, você poderá omitir o número da porta. Se um nome de proxy estiver listado por si só, você poderá usá-lo como o proxy padrão para quaisquer protocolos que não tenham um proxy especificado. Por exemplo, "http=http://http_proxyother_proxy" usa http_proxy para qualquer operação HTTP, enquanto o protocolo HTTPS usa o proxy chamado other_proxy.

Você pode listar nomes de host conhecidos localmente ou endereços IP na lista de bypass de proxy. Esse nome pode conter caracteres curinga, como "", que fazem com que o aplicativo ignore o servidor proxy para endereços que se ajustem ao padrão especificado, por exemplo, ".microsoft.com" ou ".org". Caracteres curinga devem ser os caracteres mais à esquerda no nome. Por exemplo, "aaa". não tem suporte. Você pode especificar a <macro local> para indicar que todos os sites de intranet locais são ignorados. Os sites de intranet locais são considerados todos os servidores que não contêm um período em seu nome.

O BITS usa as configurações de proxy de Explorer da Internet do usuário se um aplicativo não especificar um uso de proxy. Esse comportamento padrão normalmente funciona se o aplicativo envia o trabalho no contexto de um usuário interativo, mas pode não funcionar se um serviço em execução como LocalSystem enviar o trabalho. Você pode especificar configurações de proxy de Explorer da Internet para LocalSystem; no entanto, é difícil detectar essas configurações quando ocorrem problemas.

Requisitos

Confira também

BG_JOB_PROXY_USAGE

IBackgroundCopyJob::GetProxySettings