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