Método IWinHttpRequest::SetAutoLogonPolicy

O método SetAutoLogonPolicy define a Política de Logon Automático atual.

Sintaxe

HRESULT SetAutoLogonPolicy(
  [in] WinHttpRequestAutoLogonPolicy AutoLogonPolicy
);

Parâmetros

AutoLogonPolicy [in]

Especifica a política de logon automático atual.

Valor retornado

Caso contrário, o valor retornado será S_OK com êxito ou um valor de erro.

Comentários

A política padrão é AutoLogonPolicy_OnlyIfBypassProxy.

Chame SetAutoLogonPolicy para definir a política de logon automático antes de chamar Enviar para enviar a solicitação.

Observação

Para Windows XP e Windows 2000, consulte a seção Requisitos de tempo de execução da página inicial do WinHTTP.

Exemplos

O exemplo de script a seguir mostra como definir a política de logon automático para nunca usar a autenticação NTLM ou Negotiate automaticamente.

// Instantiate a WinHttpRequest object.
var HttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
    
// Open an HTTP connection.
HttpReq.Open("GET", "https://www.fabrikam.com/", false);
    
// Do not automatically send user credentials.
HttpReq.SetAutoLogonPolicy(2);

// Send the HTTP Request.
HttpReq.Send();

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.
IDL	HttpRequest.idl
Biblioteca	Winhttp.lib
DLL	Winhttp.dll

Confira também

IWinHttpRequest

WinHttpRequest

Autenticação no WinHTTP

Versões do WinHTTP