Sinalizadores de opção
Os sinalizadores de opção a seguir têm suporte de WinHttpQueryOption e WinHttpSetOption.
WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS
O padrão é FALSE. Se definido como TRUE, o WinHTTP não garantirá o progresso se status retornos de chamada forem bloqueados pelo aplicativo cliente.
O aplicativo cliente deve ter um cuidado especial para executar operações mínimas dentro do retorno de chamada sem bloquear, retornar o mais rápido possível e, em particular, não deve esperar por chamadas WinHTTP subsequentes. Se ele não seguir essas diretrizes, provavelmente haverá um impacto negativo no desempenho ou um possível travamento do aplicativo. Se usada da maneira prescrita, essa opção pode melhorar o desempenho.
WINHTTP_OPTION_AUTOLOGON_POLICY
Define um valor inteiro longo sem sinal que especifica a Política de Logon Automático com um dos valores a seguir.
| Termo | Descrição |
|---|---|
| WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH | As credenciais padrão não são usadas. Observe que esse sinalizador entrará em vigor somente se você especificar o servidor pelo nome real do computador. Ele não entrará em vigor se você especificar o servidor por "localhost" ou endereço IP. |
| WINHTTP_AUTOLOGON_SECURITY_LEVEL_LOW | Um logon autenticado usando as credenciais padrão é executado para todas as solicitações. |
| WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM | Um logon autenticado usando as credenciais padrão é executado apenas para solicitações na Intranet local. |
WINHTTP_OPTION_BACKGROUND_CONNECTIONS
Ao definir essa opção em um identificador de sessão, você deve passar o número de conexões que deseja abrir. Em seguida, ao primeiro enviar uma solicitação, em vez de abrir apenas uma única conexão, o WinHttp abre várias conexões em paralelo. Isso pode melhorar o desempenho de solicitações subsequentes para o mesmo destino, o que não terá a sobrecarga do estabelecimento de conexão.
WINHTTP_OPTION_CALLBACK
Recupera o ponteiro para a função de retorno de chamada definida com WinHttpSetStatusCallback.
WINHTTP_OPTION_CLIENT_CERT_CONTEXT
Define o contexto do certificado do cliente. Se um aplicativo receber ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED, ele deverá chamar WinHttpSetOption para fornecer um certificado antes de tentar novamente a solicitação. Como parte do processamento dessa opção, o WinHttp chama CertDuplicateCertificateContext no contexto de certificado fornecido pelo chamador para que o contexto do certificado possa ser liberado independentemente pelo chamador.
Observação
O aplicativo não deve tentar fechar o repositório de certificados com o sinalizador CERT_CLOSE_STORE_FORCE_FLAG na chamada para CertCloseStore no repositório de certificados do qual o contexto do certificado foi recuperado. Pode ocorrer uma violação de acesso.
Quando o servidor solicita um certificado de cliente, WinHttpSendRequest ou WinHttpReceiveResponse retorna um erro de ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED . Se o servidor solicitar o certificado, mas não o exigir, o aplicativo poderá especificar essa opção para indicar que ele não tem um certificado. O servidor pode escolher outro esquema de autenticação ou permitir acesso anônimo ao servidor. O aplicativo fornece a macro WINHTTP_NO_CLIENT_CERT_CONTEXT no parâmetro lpBuffer de WinHttpSetOption , conforme mostrado no exemplo de código a seguir.
BOOL fRet = WinHttpSetOption(hRequest,
WINHTTP_OPTION_CLIENT_CERT_CONTEXT,
WINHTTP_NO_CLIENT_CERT_CONTEXT,
0);
Se o servidor exigir um certificado do cliente, ele poderá enviar um código http status 403 em resposta. Para obter mais informações, consulte a opção WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST .
WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST
Recupera uma estrutura SecPkgContext_IssuerListInfoEx quando o erro de WinHttpSendRequest ou WinHttpReceiveResponse é ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED. A lista de emissores na estrutura contém uma lista de AC (Autoridades de Certificação) aceitáveis do servidor. O aplicativo cliente pode filtrar a lista de AC para recuperar o certificado do cliente para autenticação SSL.
Como alternativa, se o servidor solicitar o certificado do cliente, mas não o exigir, o aplicativo poderá chamar WinHttpSetOption com a opção WINHTTP_OPTION_CLIENT_CERT_CONTEXT . Para obter mais informações, consulte a opção WINHTTP_OPTION_CLIENT_CERT_CONTEXT .
WINHTTP_OPTION_CODEPAGE
Define a página de código usada para processar a URL (ou seja, cadeia de caracteres de consulta). O padrão é UTF8.
WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH
Define um valor inteiro longo sem sinal que especifica se a Autenticação do Passport na autenticação WinHTTP está habilitada. O valor pode ser um dos seguintes:
| Termo | Descrição |
|---|---|
| WINHTTP_DISABLE_PASSPORT_AUTH | A autenticação do Microsoft Passport está desabilitada. Esse é o padrão. |
| WINHTTP_DISABLE_PASSPORT_KEYRING | O keyring do Passport está desabilitado. Esse é o padrão. |
| WINHTTP_ENABLE_PASSPORT_AUTH | A autenticação do Passport está habilitada. |
| WINHTTP_ENABLE_PASSPORT_KEYRING | O keyring do Passport está habilitado. |
WINHTTP_OPTION_CONNECT_RETRIES
Define ou recupera um valor inteiro longo sem sinal que contém o número de vezes queWinHTTP tenta se conectar a um host. O WinHTTP (Microsoft Windows HTTP Services) tenta apenas uma vez por endereço IP (Protocolo IP). Por exemplo, se você tentar se conectar a um host multihomed com 10 endereços IP e WINHTTP_OPTION_CONNECT_RETRIES estiver definido como 7, o WinHTTP tentará se conectar apenas aos sete primeiros endereços IP. Dado o mesmo conjunto de 10 endereços IP, se WINHTTP_OPTION_CONNECT_RETRIES estiver definido como 20, o WinHTTP tentará cada um dos 10 apenas uma vez. Se uma tentativa de conexão ainda falhar após o número especificado de tentativas ou se o tempo limite de conexão expirar antes disso, a solicitação será cancelada. O valor padrão para WINHTTP_OPTION_CONNECT_RETRIES é cinco tentativas.
WINHTTP_OPTION_CONNECT_TIMEOUT
Define ou recupera um valor inteiro longo sem sinal que contém o valor de tempo limite, em milissegundos. Definir essa opção como infinito (0xFFFFFFFF) desabilitará esse temporizador.
Se uma solicitação de conexão TCP demorar mais do que esse valor de tempo limite, a solicitação será cancelada. O tempo limite padrão é de 60 segundos. Quando você está tentando se conectar a vários endereços IP para um único host (um host multihomed), o limite de tempo limite é para cada conexão individual.
WINHTTP_OPTION_CONNECTION_INFO
Recupera o endereço IP de origem e destino e a porta da solicitação que gerou a resposta quando WinHttpReceiveResponse retorna. O aplicativo chama WinHttpQueryOption com a opção WINHTTP_OPTION_CONNECTION_INFO e fornece a estrutura WINHTTP_CONNECTION_INFO no parâmetro lpBuffer . Para obter mais informações, consulte WINHTTP_CONNECTION_INFO.
Aplica-se a: Windows XP com SP2 e posterior; Windows 2003 com SP1 e posterior.
WINHTTP_OPTION_CONNECTION_GUID
Marque a conexão associada ao identificador de solicitação WinHTTP com um GUID. Isso permite o controle personalizado sobre quais solicitações usam quais grupos de conexões com a opção WINHTTP_OPTION_MATCH_CONNECTION_GUID .
WINHTTP_OPTION_CONNECTION_STATS_V0
Retreia o struct TCP_INFO_v0 para a conexão subjacente usada pela solicitação. O struct retornado pode conter estatísticas de solicitações anteriores enviadas pela mesma conexão.
Observação
Essa opção foi substituída por WINHTTP_OPTION_CONNECTION_STATS_V1.
WINHTTP_OPTION_CONNECTION_STATS_V1
Retreia o struct TCP_INFO_v1 para a conexão subjacente usada pela solicitação. O struct retornado pode conter estatísticas de solicitações anteriores enviadas pela mesma conexão.
WINHTTP_OPTION_CONTEXT_VALUE
Define ou recupera um DWORD_PTR que contém um ponteiro para o valor de contexto associado a esse identificador HINTERNET . O valor armazenado no buffer é usado e o sinalizador de opção WINHTTP_OPTION_CONTEXT_VALUE recebe um novo valor.
WINHTTP_OPTION_DECOMPRESSION
Define um DWORD de sinalizadores que determinam se o WinHTTP descompactará automaticamente os corpos de resposta com codificações de conteúdo compactadas. O WinHTTP também definirá um cabeçalho Accept-Encoding apropriado, substituindo qualquer fornecido pelo chamador. Os valores com suporte são:
| Termo | Descrição |
|---|---|
| WINHTTP_DECOMPRESSION_FLAG_GZIP | Descompactar Content-Encoding: respostas gzip. |
| WINHTTP_DECOMPRESSION_FLAG_DEFLATE | Descompactar a Codificação de Conteúdo: esvaziar respostas. |
| WINHTTP_DECOMPRESSION_FLAG_ALL | Descompacte as respostas com qualquer Codificação de Conteúdo com suporte. |
Por padrão, o WinHTTP fornecerá respostas compactadas ao chamador não modificado.
WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING
Definir essa opção em um identificador de sessão WinHttp permite habilitar/desabilitar se a cadeia de certificados do servidor foi criada.
WINHTTP_OPTION_DISABLE_FEATURE
Define um valor inteiro longo sem sinal que especifica quais recursos estão desabilitados com um ou mais dos sinalizadores a seguir. Lembre-se de que esse recurso só deve ser passado para WinHttpSetOption em identificadores de solicitação depois que o identificador de solicitação for criado com WinHttpOpenRequest e antes que a solicitação seja enviada com WinHttpSendRequest.
| Termo | Descrição |
|---|---|
| WINHTTP_DISABLE_AUTHENTICATION | A autenticação automática está desabilitada. |
| WINHTTP_DISABLE_COOKIES | A adição automática de cabeçalhos de cookie às solicitações está desabilitada. Além disso, os cookies retornados não são adicionados automaticamente ao banco de dados de cookie. Desabilitar cookies pode resultar em um desempenho ruim para a autenticação do Passport. |
| WINHTTP_DISABLE_KEEP_ALIVE | Desabilita a semântica keep alive para a conexão. A semântica keep alive é necessária para MSN, NTLM e outros tipos de autenticação. |
| WINHTTP_DISABLE_REDIRECTS | O redirecionamento automático é desabilitado ao enviar solicitações com WinHttpSendRequest. Se o redirecionamento automático estiver desabilitado, um aplicativo deverá registrar uma função de retorno de chamada para que a autenticação do Passport tenha êxito. |
WINHTTP_OPTION_DISABLE_GLOBAL_POOLING
Desabilita o pool global entre sessões. Essa é uma prática recomendada porque o pooling global entre sessões é um comportamento herdado com suporte por padrão por motivos de compatibilidade. Isso é afetado pela configuração posterior das conexões máximas manualmente.
WINHTTP_OPTION_DISABLE_PROXY_AUTH_SCHEMES
Desabilita uma ou mais das seguintes práticas de autenticação de proxy na sessão WinHTTP fornecendo todas OR as opções aplicáveis. Todos esses são esquemas, exceto para WINHTTP_PROXY_DISABLE_AUTH_LOCAL_SERVICE, o que força o uso da conta de computador local ao enviar solicitações para um loopback ou endereço local. Isso impede o vazamento de credenciais do sistema para proxies HTTP locais.
| Termo | Descrição |
|---|---|
| WINHTTP_PROXY_DISABLE_SCHEME_BASIC | Desabilita o esquema de autenticação básica. |
| WINHTTP_PROXY_DISABLE_SCHEME_DIGEST | Desabilita o esquema de autenticação digest. |
| WINHTTP_PROXY_DISABLE_SCHEME_NTLM | Desabilita o esquema de autenticação NTLM. |
| WINHTTP_PROXY_DISABLE_SCHEME_KERBEROS | Desabilita o esquema de autenticação Kerberos. |
| WINHTTP_PROXY_DISABLE_SCHEME_NEGOTIATE | Desabilita o esquema de autenticação Negotiate. |
| WINHTTP_PROXY_DISABLE_AUTH_LOCAL_SERVICE | Força o uso da conta de computador local ao enviar solicitações para um loopback ou endereço local. |
WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK
Impede que o WinHTTP tente novamente uma conexão com uma versão inferior do protocolo de segurança quando a negociação de protocolo inicial falhar.
WINHTTP_OPTION_DISABLE_STREAM_QUEUE
Permite que novas solicitações abram uma conexão HTTP/2 adicional quando o limite máximo de fluxo simultâneo é atingido, em vez de aguardar o próximo fluxo disponível em uma conexão existente.
WINHTTP_OPTION_ENABLE_FEATURE
Define um valor inteiro longo sem sinal que especifica os recursos atualmente habilitados. Pode ser um dos valores a seguir.
| Termo | Descrição |
|---|---|
| WINHTTP_ENABLE_SSL_REVERT_IMPERSONATION | Se habilitado, o WinHTTP reverte temporariamente a representação do cliente durante as operações de autenticação de certificado SSL. Esse valor só pode ser definido no identificador de sessão. |
| WINHTTP_ENABLE_SSL_REVOCATION | Se habilitado, o WinHTTP permitirá a revogação de SSL. Esse valor só pode ser definido no identificador de solicitação. |
WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL
Define uma máscara de bits DWORD de versões HTTP avançadas aceitáveis. Os valores possíveis são:
| Termo | Descrição |
|---|---|
| WINHTTP_PROTOCOL_FLAG_HTTP2 (0x1) | Habilita HTTP/2 para a solicitação. |
| WINHTTP_PROTOCOL_FLAG_HTTP3 (0x2) | Habilita HTTP/3 para a solicitação. |
| Nenhum (0x0) | Restringe a solicitação a HTTP/1.1 e anterior. |
As versões herdadas do HTTP (1.1 e anterior) não podem ser desabilitadas usando essa opção. O padrão é 0x0.
WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT
Essa opção pode ser definida em um identificador de sessão WinHttp para permitir que o WinHttp use o contexto de certificado do cliente fornecido pelo chamador quando HTTP/2 estiver sendo usado.
WINHTTP_OPTION_ENABLETRACING
Define um valor BOOL que especifica se o rastreamento está habilitado no momento. Essa opção só pode ser definida em um identificador HINTERNETNULL. Consulte também Coletar rastreamentos WinHTTP.
WINHTTP_OPTION_ENCODE_EXTRA
Habilita a codificação de porcentagem de URL para caminho e cadeia de caracteres de consulta.
Como alternativa, você pode codificar percentual antes de chamar WinHttp.
WINHTTP_OPTION_EXPIRE_CONNECTION
Essa opção só pode ser definida em um identificador de solicitação que ainda está ativo (enviando ou recebendo). Definir essa opção instruirá o WinHttp a parar de atender solicitações na conexão associada ao identificador de solicitação passado. A conexão será fechada depois que o identificador de solicitação com o qual essa opção for chamada for concluído. Essa opção não usa parâmetros.
WINHTTP_OPTION_EXTENDED_ERROR
Recupera um valor inteiro longo sem sinal que contém um código de erro do Microsoft Windows Sockets que foi mapeado para as mensagens de erro ERROR_WINHTTP_* retornadas pela última vez neste contexto de thread. Você pode passar NULL como o valor do identificador.
WINHTTP_OPTION_FEATURE_SUPPORTED
Verifique se um sinalizador de opção fornecido tem suporte nesta versão do WinHTTP.
WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION
Por padrão, quando o WinHttp envia uma solicitação, se não houver conexões disponíveis para atender à solicitação, o WinHttp tentará estabelecer uma nova conexão e a solicitação será associada a essa nova conexão. Quando você definir essa opção, essa solicitação será atendida na primeira conexão que se torna disponível e não necessariamente aquela que está sendo estabelecida.
WINHTTP_OPTION_GLOBAL_PROXY_CREDS
Usa um ponteiro para uma estrutura WINHTTP_CREDS_EX com o parâmetro de função hInternet definido como NULL. Essa opção requer a chave do Registro HKLM\Software\Microsoft\Windows\CurrentVersion\Configurações da Internet! ShareCredsWithWinHttp. Se essa chave do Registro não estiver definida, WinHTTP retornará o erro ERROR_WINHTTP_INVALID_OPTION. Essa chave do Registro não está presente por padrão. Quando estiver definido, o WinINet enviará credenciais para o WinHTTP. Sempre que o WinHttp receber um desafio de autenticação e se não houver credenciais definidas no identificador atual, ele usará as credenciais fornecidas pelo WinINet. Para compartilhar credenciais de servidor além das credenciais de proxy, os usuários precisam definir WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .
WINHTTP_OPTION_GLOBAL_SERVER_CREDS
Usa um ponteiro para uma estrutura WINHTTP_CREDS_EX com o parâmetro de função hInternet definido como NULL. Essa opção requer a chave do Registro HKLM\Software\Microsoft\Windows\CurrentVersion\Configurações da Internet! ShareCredsWithWinHttp. Se essa chave do Registro não estiver definida, WinHTTP retornará o erro ERROR_WINHTTP_INVALID_OPTION. Essa chave do Registro não está presente por padrão. Quando estiver definido, o WinINet enviará credenciais para o WinHTTP. Sempre que o WinHttp receber um desafio de autenticação e se não houver credenciais definidas no identificador atual, ele usará as credenciais fornecidas pelo WinINet. Para compartilhar credenciais de servidor além das credenciais de proxy, os usuários precisam definir WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .
WINHTTP_OPTION_HANDLE_TYPE
Recupera um valor inteiro longo sem sinal que contém o tipo do identificador HINTERNET passado. O valor de retorno pode ser um dos seguintes:
| Termo | Descrição |
|---|---|
| WINHTTP_HANDLE_TYPE_CONNECT | O identificador é um identificador de conexão. |
| WINHTTP_HANDLE_TYPE_REQUEST | O identificador é um identificador de solicitação. |
| WINHTTP_HANDLE_TYPE_SESSION | O identificador é um identificador de sessão. |
WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED
Impede que versões de protocolo diferentes daquelas habilitadas por WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL sejam usadas para a solicitação.
WINHTTP_OPTION_HTTP_PROTOCOL_USED
Obtém um DWORD que indica qual versão HTTP avançada foi usada em uma determinada solicitação. Para obter uma lista de valores possíveis, consulte WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL.
WINHTTP_OPTION_HTTP_VERSION
Define ou recupera uma estrutura HTTP_VERSION_INFO que contém a versão HTTP com suporte. Essa é uma opção em todo o processo; use NULL para o identificador.
WINHTTP_OPTION_HTTP2_KEEPALIVE
Essa opção pode ser definida em um identificador de sessão para que o WinHttp use quadros DE PING HTTP/2 como um mecanismo keepalive. Os chamadores especificam um tempo limite em milissegundos e, depois que não houver nenhuma atividade em uma conexão para esse período de tempo limite, o WinHttp começará a enviar quadros DE PING HTTP/2. Os chamadores não podem definir um valor de tempo limite inferior a 5000 milissegundos.
WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING
Essa opção pode ser definida em um identificador de solicitação WinHttp para controlar como o WinHttp se comporta quando uma resposta HTTP/2 contém um cabeçalho "Transfer-Encoding". Nesse caso, WinHttp retornará um erro se essa opção estiver definida como FALSE.
WINHTTP_OPTION_HTTP2_RECEIVE_WINDOW
Defina o tamanho inicial da janela de recebimento do fluxo HTTP/2 e o limite para enviar atualizações de janela usando o struct WINHTTP_HTTP2_RECEIVE_WINDOW .
WINHTTP_OPTION_HTTP3_HANDSHAKE_TIMEOUT
Usa o buffer para definir o tempo limite de handshake HTTP/3 em milissegundos como um PDWORD.
WINHTTP_OPTION_HTTP3_INITIAL_RTT
Configura o RTT inicial em milissegundos usados pelo msquic.
WINHTTP_OPTION_HTTP3_KEEPALIVE
Habilita a semântica keep alive para a conexão. Usa o buffer para definir o tempo limite de keep alive em milissegundos como um PDWORD.
WINHTTP_OPTION_HTTP3_STREAM_ERROR_CODE
Recupera o erro fornecido pelo servidor no fluxo HTTP/3 usado para enviar a solicitação.
WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE
Permite que conexões seguras usem certificados de segurança para os quais a lista de revogação de certificados não pôde ser baixada.
WINHTTP_OPTION_IPV6_FAST_FALLBACK
Habilita o fallback rápido IPv6 (Olhos Mais Felizes) para a conexão. Esse comportamento é semelhante ao comportamento de Happy Eyeballs descrito no RFC 6555 para melhorar os tempos de conexão em redes em que o IPv6 não é confiável.
- Se os endereços IPv6 e IPv4 forem resolvidos para um determinado host, o WinHttp começará conectando-se ao primeiro endereço IPv6 resolvido com um tempo limite curto (300ms).
- Se essa conexão falhar, o WinHttp tentará se conectar ao primeiro endereço IPv4 resolvido com o tempo limite padrão.
- Se a segunda conexão falhar, o WinHttp repetirá o primeiro endereço IPv6 resolvido com o tempo limite padrão.
- Se a terceira conexão falhar, o WinHttp reverter ao comportamento padrão de todos os endereços restantes, tentando uma conexão com cada um com o tempo limite padrão até que uma conexão seja feita ou nenhum endereço permaneça.
WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE
Obtém se uma resposta de conexão de retorno de proxy pode ou não ser recuperada.
WINHTTP_OPTION_MATCH_CONNECTION_GUID
Usa um struct WINHTTP_MATCH_CONNECTION_GUID para informar o WinHTTP para atender à solicitação em uma conexão correspondente. Se WINHTTP_MATCH_CONNECTION_GUID_FLAG_REQUIRED estiver definido, somente conexões com um GUID correspondente poderão ser usadas. Caso contrário, conexões com GUIDs correspondentes e conexões que não estão marcadas com nenhum GUID podem ser usadas.
WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER
Define ou recupera um valor inteiro longo sem sinal que contém o número máximo de conexões permitidas por servidor HTTP/1.0. O valor padrão é INFINITE.
Aplica-se a: Windows Vista com SP1 e posterior; Windows Server 2008 e posterior.
WINHTTP_OPTION_MAX_CONNS_PER_SERVER
Define ou recupera um valor inteiro longo sem sinal que contém o número máximo de conexões permitidas por servidor. O valor padrão é INFINITE.
Quando essa opção é definida como zero, o WinHTTP define o limite do número de conexões como 2.
WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS
Define o número máximo de redirecionamentos que o WinHTTP segue; o padrão é 10. Esse limite impede que sites não autorizados façam o cliente WinHTTP pausar após um grande número de redirecionamentos.
Aplica-se a: Windows XP com SP1 e posterior; Windows 2000 com SP3 e posterior.
WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE
O número máximo de respostas de código de status informativas 100-199 ignoradas antes de retornar o código de status final para o cliente WinHTTP. Os códigos de status informativos 100-199 podem ser enviados pelo servidor antes do código final status e são descritos na especificação para HTTP/1.1 (para obter mais informações, consulte RFC 2616). O padrão é 10.
Aplica-se a: Windows XP com SP1 e posterior; Windows 2000 com SP3 e posterior.
WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE
Um limite na quantidade de dados drenados das respostas para reutilizar uma conexão, especificada em bytes. O padrão é 1 MB.
Aplica-se a: Windows XP com SP1 e posterior; Windows 2000 com SP3 e posterior.
WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE
Um conjunto associado no tamanho máximo da parte de cabeçalho da resposta do servidor, especificado em bytes. Esse limite protege o cliente de um servidor não autorizado que tenta paralisar o cliente enviando uma resposta com uma quantidade infinita de dados de cabeçalho. O valor padrão é 64 KB.
Aplica-se a: Windows XP com SP1 e posterior; Windows 2000 com SP3 e posterior.
WINHTTP_OPTION_PARENT_HANDLE
Recupera o identificador pai para esse identificador.
WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT
Recupera uma cadeia de caracteres que contém o texto de cobranding fornecido pelo servidor de logon do Passport. Essa opção deve ser recuperada imediatamente após o servidor de logon responder com um código 401 status. Um aplicativo deve passar um tamanho de buffer, em bytes, que é grande o suficiente para manter a cadeia de caracteres retornada.
WINHTTP_OPTION_PASSPORT_COBRANDING_URL
Recupera uma cadeia de caracteres que contém uma URL para um gráfico de comarcação fornecido pelo servidor de logon do Passport. Essa opção deve ser recuperada imediatamente após o servidor de logon responder com um código 401 status. Um aplicativo deve passar um tamanho de buffer, em bytes, que é grande o suficiente para manter a cadeia de caracteres retornada.
WINHTTP_OPTION_PASSPORT_RETURN_URL
Define uma opção somente leitura em um identificador de solicitação que recupera a URL de retorno do Passport.
WINHTTP_OPTION_PASSPORT_SIGN_OUT
Define a opção em um identificador de sessão para sair de qualquer logon do Passport. Um aplicativo deve passar a URL de devolução do Passport que foi recuperada com WINHTTP_OPTION_PASSPORT_RETURN_URL. Todos os cookies relacionados à URL de retorno são limpos.
WINHTTP_OPTION_PASSWORD
Define ou recupera um valor de cadeia de caracteres que contém a senha associada a um identificador de solicitação.
WINHTTP_OPTION_PROXY
Define ou recupera uma estrutura de WINHTTP_PROXY_INFO que contém os dados de proxy em um identificador de sessão ou identificador de solicitação existente. Ao recuperar dados de proxy, um aplicativo deve liberar as cadeias de caracteres lpszProxy e lpszProxyBypass contidas nessa estrutura (se não forem NULL) usando a função GlobalFree . Um aplicativo pode consultar os dados de proxy global (o proxy padrão) passando um identificador NULL .
WINHTTP_OPTION_PROXY_PASSWORD
Define ou recupera um valor de cadeia de caracteres que contém a senha usada para acessar o proxy.
WINHTTP_OPTION_PROXY_SPN_USED
Obtém o nome da entidade de segurança do servidor proxy que o WinHTTP forneceu ao SSPI durante a autenticação. Esse valor de cadeia de caracteres é usado para passar para SspiPromptForCredentials após uma falha de autenticação.
WINHTTP_OPTION_PROXY_USERNAME
Define ou recupera um valor de cadeia de caracteres que contém o nome de usuário usado para acessar o proxy.
WINHTTP_OPTION_QUIC_STATS
Recupera uma estrutura QUIC_STATISTICS que contém informações de conexão, como RTT e bytes enviados e recebidos.
WINHTTP_OPTION_READ_BUFFER_SIZE
Essa opção foi preterida; não tem efeito.
WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE
Define se a entidade de resposta proxy pode ou não ser recuperada. Essa opção está desabilitada por padrão.
WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT
Define ou recupera um valor inteiro longo sem sinal que contém o valor de tempo limite, em milissegundos, para aguardar para receber todos os cabeçalhos de resposta para uma solicitação. Se o WinHTTP não receber todos os cabeçalhos nesse período de tempo limite, a solicitação será cancelada. O valor de tempo limite padrão é 90 segundos.
Esse tempo limite é verificado somente quando os dados são recebidos do soquete. Como resultado, quando o tempo limite expirar, o aplicativo cliente não será notificado até que mais dados cheguem do servidor. Se nenhum dado chegar do servidor, o atraso entre a expiração do tempo limite e a notificação do aplicativo cliente poderá ser tão grande quanto o valor de tempo limite definido usando o parâmetro dwReceiveTimeout da função WinHttpSetTimeouts .
WINHTTP_OPTION_RECEIVE_TIMEOUT
Define ou recupera um valor inteiro longo sem sinal que contém o valor de tempo limite, em milissegundos, para receber uma resposta parcial a uma solicitação ou ler alguns dados. Se a resposta demorar mais do que esse valor de tempo limite, a solicitação será cancelada. O valor do tempo limite padrão é de 30 segundos.
WINHTTP_OPTION_REDIRECT_POLICY
Define o comportamento do WinHTTP em relação ao tratamento de um código de redirecionamento HTTP 30x status. Essa opção pode ser definida em uma sessão ou identificador de solicitação para um dos seguintes valores:
| Termo | Descrição |
|---|---|
| WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS | Todos os redirecionamentos são seguidos automaticamente. |
| WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP | Todos os redirecionamentos são seguidos, exceto aqueles que se originam de uma URL segura (https) para uma URL não segura (http). Essa é a configuração padrão. |
| WINHTTP_OPTION_REDIRECT_POLICY_NEVER | Os redirecionamentos nunca são seguidos. O status 30x é retornado ao aplicativo. |
WINHTTP_OPTION_REJECT_USERPWD_IN_URL
Rejeita URLs que contêm um nome de usuário e senha. Essa opção também rejeita URLs que contêm semântica username:password , mesmo que nenhum nome de usuário ou senha seja especificado. Por exemplo, "u:p@hostname", ":@hostname", "u:@hostname" e ":p@hostname" seriam sinalizados como inválidos. Se uma URL inválida for passada para a função, ela retornará ERROR_WINHTTP_INVALID_URL. Essa opção é desativada por padrão.
WINHTTP_OPTION_REQUEST_ANNOTATION
Habilita a obtenção e a definição de uma anotação de solicitação para o nome de anotação fornecido. Isso permite que o chamador anexe uma cadeia de caracteres à solicitação de recuperação posterior para identificar solicitações por qualquer lógica personalizada que o chamador achar útil.
WINHTTP_OPTION_REQUEST_PRIORITY
Essa opção foi preterida; não tem efeito.
WINHTTP_OPTION_REQUEST_STATS
Retreive estatísticas para a solicitação. Para obter uma lista das estatísticas disponíveis, consulte WINHTTP_REQUEST_STATS.
WINHTTP_OPTION_REQUEST_TIMES
Retreia informações de tempo para a solicitação. Para obter uma lista dos intervalos disponíveis, consulte WINHTTP_REQUEST_TIMES.
WINHTTP_OPTION_REQUIRE_STREAM_END
Essa opção informa ao WinHttp para ignorar cabeçalhos de resposta "Comprimento do Conteúdo" e continuar recebendo em um fluxo até que o sinalizador END_STREAM seja recebido.
WINHTTP_OPTION_RESOLUTION_HOSTNAME
Essa opção pode ser definida em um identificador de solicitação WinHttp antes de ser enviada. Se definido, o WinHttp usará a cadeia de caracteres fornecida pelo chamador como o nome do host para resolução DNS.
WINHTTP_OPTION_RESOLVE_TIMEOUT
Define ou recupera um valor inteiro longo sem sinal que contém o valor de tempo limite, em milissegundos, para resolve um nome de host. O valor de tempo limite padrão é INFINITE. Se um valor não padrão for especificado, haverá uma sobrecarga de uma criação de thread por resolução de nome.
WINHTTP_OPTION_REVERT_IMPERSONATION_SERVER_CERT
Reverte qualquer representação de thread ao criar a cadeia de certificados do servidor, forçando o uso do token de processo.
WINHTTP_OPTION_SECURE_PROTOCOLS
Define um valor inteiro longo sem sinal que especifica quais protocolos seguros são aceitáveis.
- Windows 11, Windows 10 e Windows 8.1. Por padrão, somente SSL3, TLS1.0, TLS1.1 e TLS1.2 estão habilitados.
- Windows 8 e Windows 7. Por padrão, somente SSL3 e TLS1 estão habilitados.
O valor pode ser uma combinação de um ou mais dos valores a seguir.
| Termo | Descrição |
|---|---|
| WINHTTP_FLAG_SECURE_PROTOCOL_ALL | Os protocolos SSL (Secure Sockets Layer) 2.0, SSL 3.0 e TLS (Transport Layer Security) 1.0 podem ser usados. |
| WINHTTP_FLAG_SECURE_PROTOCOL_SSL2 | O protocolo SSL 2.0 pode ser usado. |
| WINHTTP_FLAG_SECURE_PROTOCOL_SSL3 | O protocolo SSL 3.0 pode ser usado. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1 | O protocolo TLS 1.0 pode ser usado. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_1 | O protocolo TLS 1.1 pode ser usado. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_2 | O protocolo TLS 1.2 pode ser usado. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_3 | O protocolo TLS 1.3 pode ser usado. |
Se você precisar adicionar suporte para protocolos TLS 1.1 ou TLS 1.2, mas não conseguir recompilar o aplicativo para usar os valores apropriados de WINHTTP_OPTION_SECURE_PROTOCOLS, poderá adicionar a entrada do DefaultSecureProtocols Registro. Essa entrada do Registro permite especificar quais protocolos SSL devem ser usados quando o sinalizador WINHTTP_OPTION_SECURE_PROTOCOLS é usado.
Importante
As instruções a seguir envolvem a modificação do registro. No entanto, problemas graves podem ocorrer se você modificar o Registro incorretamente. Portanto, certifique-se de seguir estas instruções com cuidado. Para maior proteção, faça backup do Registro antes de modificá-lo. Assim, será possível restaurá-lo se houver algum problema. Para obter mais informações sobre como fazer backup e restaurar o registro, consulte Como fazer backup e restaurar o registro no Windows.
Quando um aplicativo especifica WINHTTP_OPTION_SECURE_PROTOCOLS, o sistema verifica a DefaultSecureProtocols entrada do Registro e, se estiver presente, substitui os protocolos padrão especificados por WINHTTP_OPTION_SECURE_PROTOCOLS com os protocolos especificados na entrada do DefaultSecureProtocols Registro. Se a entrada do Registro não estiver presente, o WinHTTP usará os padrões de sistema operacional existentes para WINHTTP_OPTION_SECURE_PROTOCOLS. Esses padrões do WinHTTP seguem as regras de precedência existentes e são rejeitados por protocolos e protocolos desabilitados do Schannel (Secure Channel) definidos por aplicativo por WinHttpSetOption.
Você pode adicionar a entrada do DefaultSecureProtocols Registro no seguinte caminho:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp
Em computadores baseados em x64, você também deve adicionar DefaultSecureProtocols ao Wow6432Node caminho:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp
O valor do Registro é um bitmap DWORD. O valor a ser usado é determinado adicionando os valores correspondentes aos protocolos desejados.
| Valor defaultSecureProtocols | Protocolo habilitado |
|---|---|
| 0x00000008 | Habilitar o SSL 2.0 por padrão |
| 0x00000020 | Habilitar o SSL 3.0 por padrão |
| 0x00000080 | Habilitar o TLS 1.0 por padrão |
| 0x00000200 | Habilitar o TLS 1.1 por padrão |
| 0x00000800 | Habilitar o TLS 1.2 por padrão |
Por exemplo, se você quiser substituir os valores padrão para WINHTTP_OPTION_SECURE_PROTOCOLS especificar TLS 1.1 e TLS 1.2. Nesse caso, pegue o valor de TLS 1.1 (0x00000200) e o valor de TLS 1.2 (0x00000800), adicione-os juntos na calculadora (no modo programador) e o valor resultante do Registro seria 0x00000A00.
WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT
Recupera o certificado de um servidor SSL/TLS na estrutura WINHTTP_CERTIFICATE_INFO . O aplicativo deve liberar os membros lpszSubjectInfo e lpszIssuerInfo com LocalFree.
WINHTTP_OPTION_SECURITY_FLAGS
Define ou recupera um valor inteiro longo sem sinal que contém os sinalizadores de segurança de um identificador. Pode ser uma combinação desses valores:
| Termo | Descrição |
|---|---|
| SECURITY_FLAG_IGNORE_CERT_CN_INVALID | Permite um nome comum inválido em um certificado; ou seja, o nome do servidor especificado pelo aplicativo não corresponde ao nome comum no certificado. Se esse sinalizador for definido, o aplicativo não receberá um retorno de chamada WINHTTP_CALLBACK_STATUS_FLAG_CERT_CN_INVALID . |
| SECURITY_FLAG_IGNORE_CERT_DATE_INVALID | Permite uma data de certificado inválida, ou seja, um certificado expirado ou ainda não efetivo. Se esse sinalizador for definido, o aplicativo não receberá um retorno de chamada WINHTTP_CALLBACK_STATUS_FLAG_CERT_DATE_INVALID . |
| SECURITY_FLAG_IGNORE_UNKNOWN_CA | Permite uma autoridade de certificação inválida. Se esse sinalizador estiver definido, o aplicativo não receberá um retorno de chamada WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA . |
| SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE | Permite que a identidade de um servidor seja estabelecida com um certificado não servidor (por exemplo, um certificado de cliente). |
| SECURITY_FLAG_IGNORE_WEAK_SIGNATURE | Permite que uma assinatura fraca seja ignorada. Esse sinalizador está disponível na atualização cumulativo de atualizações para cada sistema operacional começando com o Windows 7 e o Windows Server 2008 R2. |
| SECURITY_FLAG_SECURE | Usa transferências seguras. Isso só é retornado em uma chamada para WinHttpQueryOption. |
| SECURITY_FLAG_STRENGTH_MEDIUM | Usa criptografia média (56 bits). Isso só é retornado em uma chamada para WinHttpQueryOption. |
| SECURITY_FLAG_STRENGTH_STRONG | Usa criptografia forte (128 bits). Isso só é retornado em uma chamada para WinHttpQueryOption. |
| SECURITY_FLAG_STRENGTH_WEAK | Usa criptografia fraca (40 bits). Isso só é retornado em uma chamada para WinHttpQueryOption. |
WINHTTP_OPTION_SECURITY_INFO
Retreia as informações de conexão e criptografia do SChannel para uma solicitação.
WINHTTP_OPTION_SECURITY_KEY_BITNESS
Recupera um valor inteiro longo sem sinal que contém a força da criptografia da chave de criptografia. Um número maior indica criptografia de força de codificação mais forte.
WINHTTP_OPTION_SEND_TIMEOUT
Define ou recupera um valor inteiro longo sem sinal que contém o valor de tempo limite, em milissegundos, para enviar uma solicitação ou gravar alguns dados. Se o envio da solicitação demorar mais do que o tempo limite, a operação de envio será cancelada. O tempo limite padrão é 30 segundos.
WINHTTP_OPTION_SERVER_CBT
Obtém um ponteiro para SecPkgContext_Bindings estrutura que especifica um CBT (Token de Associação de Canal).
Um Token de Associação de Canal é uma propriedade de um canal de transporte seguro e é usado para associar um canal de autenticação ao canal de transporte seguro. Esse token só pode ser obtido por essa opção depois que uma conexão SSL for estabelecida.
Observação
Passar essa opção e um valor nulo para lpBuffer para WinHttpQueryOption retornará ERROR_INSUFFICIENT_BUFFER e o tamanho de byte necessário para o buffer no parâmetro lpdwBufferLength . Esse valor de tamanho de buffer retornado pode ser passado em uma chamada subsequente para consultar o Token de Associação de Canal. Essas etapas são necessárias ao lidar com WINHTTP_CALLBACK_STATUS_REQUEST se você quiser modificar cabeçalhos de solicitação com base no Token de Associação de Canal. Observe que o Windows XP e o Vista não dão suporte à modificação de cabeçalhos de solicitação durante esse retorno de chamada.
WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT
Recupera o contexto da cadeia de certificação do servidor. WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT pode ser passado para obter um ponteiro duplicado para o CERT_CHAIN_CONTEXT de uma cadeia de certificados de servidor recebida durante uma conexão SSL negociada. O cliente deve chamar CertFreeCertificateContext no ponteiro PCCERT_CONTEXT retornado que é preenchido no buffer.
WINHTTP_OPTION_SERVER_CERT_CONTEXT
Recupera o contexto de certificação do servidor. WINHTTP_OPTION_SERVER_CERT_CONTEXT pode ser passado para obter um ponteiro duplicado para o CERT CONTEXT para um certificado de servidor recebido durante uma conexão SSL negociada. O cliente deve chamar CertFreeCertificateContext no ponteiro PCCERT_CONTEXT retornado que é preenchido no buffer.
WINHTTP_OPTION_SERVER_SPN_USED
Obtém o nome da entidade de segurança do servidor que o WinHTTP forneceu ao SSPI durante a autenticação. Esse valor de cadeia de caracteres pode ser passado para SspiPromptForCredentials após uma falha de autenticação.
WINHTTP_OPTION_SPN
Inclui ou remove o número da porta do servidor quando o SPN (nome da entidade de serviço) é criado para autenticação Kerberos ou Negotiate Kerberos. Esse sinalizador é um dos seguintes valores:
| Termo | Descrição |
|---|---|
| WINHTTP_DISABLE_SPN_SERVER_PORT | Remove o número da porta do servidor. |
| WINHTTP_ENABLE_SPN_SERVER_PORT | Inclui o número da porta do servidor. |
WINHTTP_OPTION_STREAM_ERROR_CODE
Essa opção pode ser consultada em um identificador de solicitação WinHttp e retornará o código de erro indicado por um quadro de RST_STREAM recebido em um fluxo HTTP.
WINHTTP_OPTION_TCP_FAST_OPEN
Habilita o TCP Fast Open para a conexão.
WINHTTP_OPTION_TCP_KEEPALIVE
Essa opção pode ser definida em um identificador de sessão WinHttp para habilitar o comportamento keep alive do TCP no soquete subjacente. Usa um struct tcp_keepalive .
WINHTTP_OPTION_TLS_FALSE_START
Habilita o Início Falso do TLS para a conexão.
WINHTTP_OPTION_TCP_PRIORITY_STATUS
Consulte a prioridade sugerida do conjunto de soquetes TCP com WINHTTP_OPTION_TCP_PRIORITY_HINT. Consulte a documentação do SIO_SET_PRIORITY_HINT para obter mais detalhes.
WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK
Essa opção pode ser definida em um identificador de sessão WinHttp para controlar se o fallback para TLS 1.0 é permitido se houver uma falha de handshake do TLS com uma versão de protocolo mais recente.
WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT
Usa um evento que será definido quando o último retorno de chamada for concluído para uma sessão específica. Esse sinalizador deve ser usado em um identificador de sessão. O evento não pode ser fechado até que tenha sido definido pelo WinHTTP.
WINHTTP_OPTION_UNSAFE_HEADER_PARSING
Essa opção é reservada para uso interno e não deve ser chamada.
WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET
Instrui a pilha a iniciar um processo de handshake do WebSocket com WinHttpSendRequest. Essa opção não usa parâmetros.
WINHTTP_OPTION_URL
Recupera um valor de cadeia de caracteres que contém a URL completa de um recurso baixado. Se a URL original contiver dados extras, como cadeias de caracteres de pesquisa ou âncoras, ou se a chamada tiver sido redirecionada, a URL retornada será diferente da original. O aplicativo deve passar um buffer, dimensionado em bytes, que é grande o suficiente para manter a URL retornada em caractere largo.
WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS
Usa um BOOL e pode ser definido apenas como um identificador de sessão. Ele só será propagado para os identificadores criados a partir do identificador de sessão depois que a opção tiver sido definida. Se TRUE, essa opção causará, como último recurso, o uso de credenciais de servidor global que foram enviadas por push do WinInet. O padrão para essa opção é FALSE. Essa opção requer a chave do Registro HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Essa chave do Registro não está presente por padrão. Quando estiver definido, o WinINet enviará credenciais para o WinHTTP. Sempre que o WinHttp receber um desafio de autenticação e se não houver credenciais definidas no identificador atual, ele usará as credenciais fornecidas pelo WinINet.
WINHTTP_OPTION_USE_SESSION_SCH_CRED
Permite que a configuração de uma única credencial seja usada por padrão para todos os pontos de extremidade dentro da sessão, em vez de ter credenciais padrão por ponto de extremidade. Isso pode melhorar o desempenho reduzindo a sobrecarga de gerenciamento de credenciais. Observe que essa credencial padrão não terá efeito quando um certificado do cliente for fornecido explicitamente.
WINHTTP_OPTION_USER_AGENT
Define ou recupera a cadeia de caracteres do agente do usuário em identificadores fornecidos pelo WinHttpOpen e usados nas funções WinHttpSendRequest subsequentes, desde que não seja substituído por um cabeçalho adicionado por WinHttpAddRequestHeaders ou WinHttpSendRequest. Ao recuperar um agente de usuário, o aplicativo deve passar um buffer, dimensionado em bytes, que é grande o suficiente para manter a URL retornada em caractere largo. Ao definir o agente do usuário, o tamanho do buffer é o comprimento da cadeia de caracteres, em caracteres, mais o terminador NULL .
WINHTTP_OPTION_USERNAME
Define ou recupera uma cadeia de caracteres que contém o nome de usuário.
WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT
Define o tempo, em milissegundos, que WinHttpWebSocketClose deve aguardar para concluir o handshake de fechamento. O padrão é 10 segundos.
WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL
Define o intervalo, em milissegundos, para enviar um pacote keep alive pela conexão. O intervalo padrão é 30000 (30 segundos). O intervalo mínimo é 15000 (15 segundos). Usar WinHttpSetOption para definir um valor inferior a 15000 retornará com ERROR_INVALID_PARAMETER.
Observação
O valor padrão para WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL é lido de HKLM:\SOFTWARE\Microsoft\WebSocket\KeepaliveInterval. Se um valor não for definido, o valor padrão de 30000 será usado. Não é possível ter um intervalo keepalive inferior a 15000 milissegundos.
WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE
Define ou recupera um DWORD que especifica o tamanho do buffer de recebimento a ser usado em conexões WebSocket.
WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE
Define ou recupera um DWORD que especifica o tamanho do buffer de envio a ser usado em conexões WebSocket.
WINHTTP_OPTION_WORKER_THREAD_COUNT
Define um valor inteiro longo sem sinal que especifica o número de threads de trabalho que o pool de threads deve usar para conclusões assíncronas. O valor padrão dessa opção é zero, que especifica que o número de threads de trabalho é igual ao número de CPUs no sistema. Essa opção só pode ser definida em um identificador HINTERNETNULL antes de ocorrer uma operação assíncrona. Essa opção só pode ser definida uma vez.
Aplica-se a: Windows 7 e posterior; Windows Server 2008 R2 e posterior.
WINHTTP_OPTION_WRITE_BUFFER_SIZE
Essa opção foi preterida; não tem efeito.
Comentários
A tabela a seguir lista os sinalizadores de opção especificando quais identificadores eles podem agir, se podem ser consultados e definidos e o tipo de dados usado. Um "X" indica que o sinalizador de opção é válido para uso com a função ou identificador, enquanto um "-" especifica que o sinalizador de opção é inválido.
Tentar definir ou consultar um sinalizador de opção em uma versão do Windows em que não há suporte resultará em ERROR_WINHTTP_INVALID_OPTION.
| Sinalizador de opção e tipo de dados | Identificador de sessão | Identificador de solicitação | Opção de consulta | Opção Set | Versão mínima do Windows |
|---|---|---|---|---|---|
| WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS BOOL |
X | - | - | X | - |
| WINHTTP_OPTION_AUTOLOGON_POLICY DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_BACKGROUND_CONNECTIONS DWORD |
X | - | - | X | Windows 10 versão 21H1 |
| WINHTTP_OPTION_CALLBACK LPVOID |
X | X | X | X | - |
| WINHTTP_OPTION_CLIENT_CERT_CONTEXT CERT_CONTEXT |
- | X | - | X | Windows Vista |
| WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST SecPkgContext_IssuerListInfoEx |
- | X | X | - | Windows Vista |
| WINHTTP_OPTION_CODEPAGE DWORD |
X | - | - | X | - |
| WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH DWORD |
X | - | - | X | - |
| WINHTTP_OPTION_CONNECT_RETRIES DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_CONNECT_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_CONNECTION_INFO WINHTTP_CONNECTION_INFO |
- | X | X | - | - |
| WINHTTP_OPTION_CONNECTION_STATS_V0 TCP_INFO_v0 |
- | X | X | - | Windows 10 versão 1903 |
| WINHTTP_OPTION_CONNECTION_STATS_V1 TCP_INFO_v1 |
- | X | X | - | Windows 10 versão 2004 |
| WINHTTP_OPTION_CONTEXT_VALUE DWORD_PTR |
X | X | X | X | - |
| WINHTTP_OPTION_DECOMPRESSION DWORD |
X | X | - | X | Windows 8.1 |
| WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING BOOL |
X | - | - | X | Windows 10 versão 21H1 |
| WINHTTP_OPTION_DISABLE_FEATURE DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK BOOL |
X | - | - | X | Windows 10 versão 1903 |
| WINHTTP_OPTION_DISABLE_STREAM_QUEUE BOOL |
X | X | - | X | Windows 10 versão 1809 |
| WINHTTP_OPTION_ENABLE_FEATURE DWORD |
* | * | - | X | - |
| WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL DWORD |
X | X | - | X | Windows 10, versão 1607 |
| WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT_CONTEXT BOOL |
X | - | - | X | Windows 10 versão 21H1 |
| WINHTTP_OPTION_ENABLETRACING DWORD |
- | - | X | X | - |
| WINHTTP_OPTION_ENCODE_EXTRA BOOL |
X | X | - | X | Windows 10 versão 1803 |
| WINHTTP_OPTION_EXPIRE_CONNECTION N/D |
- | X | - | X | Windows 10 versão 1903 |
| WINHTTP_OPTION_EXTENDED_ERROR DWORD |
X | X | X | - | - |
| WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION BOOL |
X | - | - | X | Windows 10 versão 21H1 |
| WINHTTP_OPTION_GLOBAL_PROXY_CREDS WINHTTP_CREDS |
X | X | - | X | - |
| WINHTTP_OPTION_GLOBAL_SERVER_CREDS WINHTTP_CREDS_EX |
X | X | - | X | - |
| WINHTTP_OPTION_HANDLE_TYPE DWORD |
X | X | X | - | - |
| WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED BOOL |
X | X | - | X | Windows 10 versão 1903 |
| WINHTTP_OPTION_HTTP_PROTOCOL_USED DWORD |
- | X | X | - | Windows 10, versão 1607 |
| WINHTTP_OPTION_HTTP_VERSION HTTP_VERSION_INFO |
X | X | X | X | - |
| WINHTTP_OPTION_HTTP2_KEEPALIVE DWORD |
X | - | - | X | Windows 10 versão 21H1 |
| WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING BOOL |
X | X | - | X | Windows 10 versão 21H1 |
| WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE BOOL |
- | X | - | X | Windows 10 versão 2004 |
| WINHTTP_OPTION_IPV6_FAST_FALLBACK BOOL |
X | - | - | X | Windows 10 versão 1903 |
| WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE BOOL |
X | X | X | - | - |
| WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER DWORD |
X | - | X | X | - |
| WINHTTP_OPTION_MAX_CONNS_PER_SERVER DWORD |
X | - | X | X | - |
| WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_PARENT_HANDLE HINTERNET |
X | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_COBRANDING_URL LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_RETURN_URL LPVOID |
- | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_SIGN_OUT LPVOID |
X | - | - | X | - |
| WINHTTP_OPTION_PASSWORD LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_PROXY WINHTTP_PROXY_INFO |
X | X | X | X | - |
| WINHTTP_OPTION_PROXY_PASSWORD LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_PROXY_SPN_USED LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_PROXY_USERNAME LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_READ_BUFFER_SIZE DWORD |
- | X | X | X | - |
| WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE BOOL |
X | X | - | X | - |
| WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_RECEIVE_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_REDIRECT_POLICY DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_REJECT_USERPWD_IN_URL BOOL |
- | X | - | X | - |
| WINHTTP_OPTION_REQUEST_PRIORITY DWORD |
- | X | X | X | - |
| WINHTTP_OPTION_REQUEST_STATS WINHTTP_REQUEST_STATS |
- | X | X | - | Windows 10 versão 1903 |
| WINHTTP_OPTION_REQUEST_TIMES WINHTTP_REQUEST_TIMES |
- | X | X | - | Windows 10 versão 1903 |
| WINHTTP_OPTION_REQUIRE_STREAM_END BOOL |
X | X | - | X | Windows 10 versão 21H1 |
| WINHTTP_OPTION_RESOLUTION_HOSTNAME LPWSTR |
- | X | - | X | Windows 10 versão 21H1 |
| WINHTTP_OPTION_RESOLVE_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_SECURE_PROTOCOLS DWORD |
X | - | - | X | - |
| WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT WINHTTP_CERTIFICATE_INFO |
- | X | X | - | - |
| WINHTTP_OPTION_SECURITY_FLAGS DWORD |
- | X | X | X | - |
| WINHTTP_OPTION_SECURITY_INFO WINHTTP_SECURITY_INFO |
- | X | X | - | Windows 10 versão 2004 |
| WINHTTP_OPTION_SECURITY_KEY_BITNESS DWORD |
- | X | X | - | - |
| WINHTTP_OPTION_SEND_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_SERVER_CBT SecPkgContext_Bindings* |
- | X | X | - | - |
| WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT CERT_CHAIN_CONTEXT |
- | X | X | - | Windows 10 versão 2004 |
| WINHTTP_OPTION_SERVER_CERT_CONTEXT CONTEXTO DE CERTIFICADO |
- | X | X | - | - |
| WINHTTP_OPTION_SERVER_SPN_USED LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_SPN DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_STREAM_ERROR_CODE DWORD |
- | X | X | - | Windows 10 versão 21H1 |
| WINHTTP_OPTION_TCP_FAST_OPEN BOOL |
X | - | - | X | Windows 10 versão 2004 |
| WINHTTP_OPTION_TCP_KEEPALIVE tcp_keepalive |
X | - | - | X | Windows 10 versão 2004 |
| WINHTTP_OPTION_TLS_FALSE_START BOOL |
X | - | - | X | Windows 10 versão 2004 |
| WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK BOOL |
X | - | - | X | Windows 10 versão 21H1 |
| WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT HINTERNET |
X | - | - | X | - |
| WINHTTP_OPTION_UNSAFE_HEADER_PARSING DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET N/D |
- | X | - | X | - |
| WINHTTP_OPTION_URL LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS BOOL |
X | X | - | X | - |
| WINHTTP_OPTION_USER_AGENT LPWSTR |
X | - | X | X | - |
| WINHTTP_OPTION_USERNAME LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT DWORD |
- | - | X | X | - |
| WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL DWORD |
- | - | X | X | - |
| WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE DWORD |
X | X | X | X | Windows 8.1 |
| WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE DWORD |
X | X | X | X | Windows 8.1 |
| WINHTTP_OPTION_WORKER_THREAD_COUNT DWORD |
- | - | - | X | - |
| WINHTTP_OPTION_WRITE_BUFFER_SIZE DWORD |
- | X | X | X | - |
Observação
Para Windows XP e Windows 2000, consulte Requisitos de tempo de execução.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho] |
| Redistribuível | WinHTTP 5.0 e Internet Explorer 5.01 ou posterior no Windows XP e Windows 2000. |
| Cabeçalho | Winhttp.h |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de