CInternetSession::OnStatusCallback

virtuel OnStatusCallback nulle (DWORD dwContext, DWORD dwInternetStatus, LPVOID lpvStatusInformation, DWORD dwStatusInformationLength );

Paramètres

dwContext

La valeur de contexte fournie par l'application.

dwInternetStatus

Un code d'État qui indique pourquoi le rappel est fait. Voir les remarques d'un tableau de valeurs possibles.

lpvStatusInformation

Un pointeur vers une mémoire tampon contenant les informations pertinentes à ce rappel.

dwStatusInformationLength

La taille de lpvStatusInformation.

Remarques

Cette fo&nction membre est appelée par le framework pour mettre à jour l'État lorsque le rappel de l'État est activé et une opération est en attente. Vous devez d'abord appeler EnableStatusCallback pour profiter de la situation callback.nbsp;

Le paramètre dwInternetStatus indique l'opération exécutée et détermine ce que sera le contenu de lpvStatusInformation . dwStatusInformationLength indique la longueur des données incluses dans lpvStatusInformation. Les valeurs d'État suivantes pour dwInternetStatus sont définis comme suit:

Valeur Sens
INTERNET_STATUS_RESOLVING_NAME Rechercher l'adresse IP du nom figurant dans la lpvStatusInformation.
INTERNET_STATUS_NAME_RESOLVED Trouvé avec succès l'adresse IP du nom figurant dans la lpvStatusInformation.
INTERNET_STATUS_CONNECTING_TO_SERVER Se connectant à l'adresse de socket (SOCKADDR) indiqué par lpvStatusInformation.
INTERNET_STATUS_CONNECTED_TO_SERVER Connecté avec succès à l'adresse de socket (SOCKADDR) indiqué par lpvStatusInformation.
INTERNET_STATUS_SENDING_REQUEST Envoi de la demande d'information sur le serveur. Le paramètre lpvStatusInformation est NULL.
INTERNET_STATUS_ REQUEST_SENT Avec succès a envoyé la demande de renseignements sur le serveur. Le paramètre lpvStatusInformation est NULL.
INTERNET_STATUS_RECEIVING_RESPONSE Le serveur de répondre à une demande en attente. Le paramètre lpvStatusInformation est NULL.
INTERNET_STATUS_RESPONSE_RECEIVED Avec succès, a reçu une réponse du serveur. Le paramètre lpvStatusInformation est NULL.
INTERNET_STATUS_CLOSING_CONNECTION Fermeture de la connexion au serveur. Le paramètre lpvStatusInformation est NULL.
INTERNET_STATUS_CONNECTION_CLOSED Fermé avec succès la connexion au serveur. Le paramètre lpvStatusInformation est NULL.
INTERNET_STATUS_HANDLE_CREATED Utilisé par la fonction API Win32 InternetConnect pour indiquer qu'il a créé la nouvelle poignée. Cela permet à la fonction d'appel Win32 application InternetCloseHandle par un autre thread si la connexion est trop longue. Voir le Kit de développement ActiveX pour plus d'informations sur ces fonctions.
INTERNET_STATUS_HANDLE_CLOSING Terminé avec succès cette valeur de handle.
INTERNET_STATUS_REQUEST_COMPLETE Terminé avec succès l'opération asynchrone. Consultez le constructeur CInternetSession pour plus de détails sur INTERNET_FLAG_ASYNC.Les points de paramètre lpvStatusInformation à une structure de INTERNET_ASYNC_RESULT et dwStatusInformationLength contient l'état d'achèvement définitif de la fonction asynchrone. Si c'est ERROR_INTERNET_EXTENDED_ERROR, l'application peut récupérer les informations d'erreur serveur à l'aide de la fonction Win32 InternetGetLastResponseInfo. Voir le Kit de développement ActiveX pour plus d'informations sur cette fonction.

Dans le cas INTERNET_STATUS_REQUEST_COMPLETE, lpvStatusInformation points à une structure INTERNET_ASYNC_RESULT , qui est défini comme:

Substituer cette fonction de membre d'exiger une action avant une routine de rappel du statut est effectuée.

&Notenbsp ;  Rappels de statut ont besoin de protection de l'État du thread. Si vous utilisez MFC dans une bibliothèque partagée, ajoutez la ligne suivante au début de votre substitution:

AFX_MANAGE_STATE (AfxGetAppModuleState ())

Pour plus d'informations sur les opérations asynchrones, consultez l'article premiers pas Internet : WinInet dans le Guide du programmeur Visual C++.

CInternetSession aperçu |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CInternetSession::EnableStatusCallback, CInternetSession::GetContext

Index