INTERNET_STATUS_CALLBACK fonction de rappel (wininet.h)
Prototype d’une fonction de rappel status définie par l’application.
Le type INTERNET_STATUS_CALLBACK définit un pointeur vers cette fonction de rappel. InternetStatusCallback est un espace réservé pour le nom de fonction défini par l’application.
Syntaxe
INTERNET_STATUS_CALLBACK InternetStatusCallback;
void InternetStatusCallback(
[in] HINTERNET hInternet,
[in] DWORD_PTR dwContext,
[in] DWORD dwInternetStatus,
[in] LPVOID lpvStatusInformation,
[in] DWORD dwStatusInformationLength
)
{...}
Paramètres
[in] hInternet
Handle pour lequel la fonction de rappel est appelée.
[in] dwContext
Pointeur vers une variable qui spécifie la valeur de contexte définie par l’application associée à hInternet.
[in] dwInternetStatus
Un status code qui indique pourquoi la fonction de rappel est appelée. Ce paramètre peut prendre les valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Fermeture de la connexion au serveur. Le paramètre lpvStatusInformation est NULL. |
|
Connexion réussie à l’adresse de socket (SOCKADDR) pointée par lpvStatusInformation. |
|
Connexion à l’adresse de socket (SOCKADDR) pointée par lpvStatusInformation. |
|
La connexion au serveur a été fermée. Le paramètre lpvStatusInformation est NULL. |
|
Récupération de contenu à partir du cache. Contient des données sur les événements de cookies passés pour l’URL, par exemple si les cookies ont été acceptés, rejetés, rétrogradés ou mis en laisse.
Le paramètre lpvStatusInformation est un pointeur vers une structure InternetCookieHistory . |
|
Indique le nombre de cookies qui ont été acceptés, rejetés, rétrogradés (de cookies persistants à de session) ou mis en laisse (ne seront envoyés que dans le contexte d’un tiers). Le paramètre lpvStatusInformation est un DWORD avec le nombre de cookies reçus. |
|
Indique le nombre de cookies qui ont été envoyés ou supprimés lorsqu’une demande est envoyée. Le paramètre lpvStatusInformation est un DWORD avec le nombre de cookies envoyés ou supprimés. |
|
Non implémenté. |
|
Avertit l’application cliente qu’un proxy a été détecté. |
|
Cette valeur de handle a été arrêtée. pvStatusInformation contient l’adresse du handle en cours de fermeture. Le paramètre lpvStatusInformation contient l’adresse du handle en cours de fermeture. |
|
Utilisé par InternetConnect pour indiquer qu’il a créé le nouveau handle. Cela permet à l’application d’appeler InternetCloseHandle à partir d’un autre thread, si la connexion prend trop de temps. Le paramètre lpvStatusInformation contient l’adresse d’un handle HINTERNET . |
|
Reçu un message de code intermédiaire (niveau 100) status du serveur. |
|
L’adresse IP du nom contenu dans lpvStatusInformation a été trouvée. Le paramètre lpvStatusInformation pointe vers un PCTSTR contenant le nom d’hôte. |
|
La réponse contient un en-tête P3P. |
|
Non implémenté. |
|
Non implémenté. |
|
Non implémenté. |
|
Attendre que le serveur réponde à une demande. Le paramètre lpvStatusInformation est NULL. |
|
Une requête HTTP est sur le point de rediriger automatiquement la requête. Le paramètre lpvStatusInformation pointe vers la nouvelle URL. À ce stade, l’application peut lire toutes les données retournées par le serveur avec la réponse de redirection et interroger les en-têtes de réponse. Il peut également annuler l’opération en fermant le handle. Ce rappel n’est pas effectué si la requête d’origine spécifiée INTERNET_FLAG_NO_AUTO_REDIRECT. |
|
Une opération asynchrone a été effectuée. Le paramètre lpvStatusInformation contient l’adresse d’une structure INTERNET_ASYNC_RESULT . |
|
Envoi de la demande d’informations au serveur. Le paramètre lpvStatusInformation pointe vers une valeur DWORD qui contient le nombre d’octets envoyés. |
|
Recherche de l’adresse IP du nom contenu dans lpvStatusInformation. Le paramètre lpvStatusInformation pointe vers un PCTSTR contenant le nom d’hôte. |
|
Réception réussie d’une réponse du serveur. |
|
Envoi de la demande d’informations au serveur. Le paramètre lpvStatusInformation est NULL. |
|
Déplacé entre un site sécurisé (HTTPS) et un site non sécurisé (HTTP). L’utilisateur doit être informé de cette modification ; dans le cas contraire, l’utilisateur risque de divulguer des informations sensibles involontairement. Lorsque cet indicateur est défini, le paramètre lpvStatusInformation pointe vers un status DWORD qui contient des indicateurs supplémentaires. |
[in] lpvStatusInformation
Pointeur vers des informations status supplémentaires. Lorsque l’indicateur INTERNET_STATUS_STATE_CHANGE est défini, lpvStatusInformation pointe vers un DWORD qui contient un ou plusieurs des indicateurs suivants :
[in] dwStatusInformationLength
Taille, en octets, des données pointées par lpvStatusInformation.
Valeur de retour
None
Remarques
Étant donné que les rappels sont effectués pendant le traitement de la demande, l’application doit consacrer peu de temps à la fonction de rappel pour éviter de dégrader le débit des données sur le réseau. Par exemple, l’affichage d’une boîte de dialogue dans une fonction de rappel peut être une opération tellement longue que le serveur met fin à la demande.
La fonction de rappel peut être appelée dans un contexte de thread différent du thread qui a lancé la demande.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | wininet.h |