Méthode IWinHttpRequest::SetAutoLogonPolicy

La méthode SetAutoLogonPolicy définit la stratégie d’ouverture de session automatique actuelle.

Syntaxe

HRESULT SetAutoLogonPolicy(
  [in] WinHttpRequestAutoLogonPolicy AutoLogonPolicy
);

Paramètres

AutoLogonPolicy [in]

Spécifie la stratégie d’ouverture de session automatique actuelle.

Valeur retournée

La valeur de retour est S_OK sur la réussite ou une valeur d’erreur dans le cas contraire.

Notes

La stratégie par défaut est AutoLogonPolicy_OnlyIfBypassProxy.

Appelez SetAutoLogonPolicy pour définir la stratégie d’ouverture de session automatique avant d’appeler Send pour envoyer la demande.

Notes

Pour Windows XP et Windows 2000, consultez la section Conditions d’exécution de la page de démarrage WinHTTP.

Exemples

L’exemple de script suivant montre comment définir la stratégie d’ouverture de session automatique pour ne jamais utiliser l’authentification NTLM ou Négocier automatiquement.

// 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();

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
Composant redistribuable	WinHTTP 5.0 et Internet Explorer 5.01 ou version ultérieure sur Windows XP et Windows 2000.
IDL	HttpRequest.idl
Bibliothèque	Winhttp.lib
DLL	Winhttp.dll

Voir aussi

IWinHttpRequest

WinHttpRequest

Authentification dans WinHTTP

WinHTTP Versions