CInternetSession::EnableStatusCallback
Appelez la fonction membre pour activer le rappel d'état.
BOOL EnableStatusCallback(
BOOL bEnable = TRUE
);
Paramètres
- bEnable
Spécifie si le rappel est activée ou désactivée. La valeur par défaut est TRUE.
Valeur de retour
Une valeur différente de zéro si l'opération a réussi ; sinon 0. Si l'appel échoue, déterminez la cause de l'échec en examinant l'objet levé de CInternetException .
Notes
En gérant le rappel d'état, vous pouvez fournir le mode sur le déroulement de l'exécution (comme résoudre le nom, la connexion au serveur, etc.) dans la barre d'état de l'application. L'affichage du mode d'exécution est particulièrement souhaitable pendant une opération à long terme.
Étant donné que les rappels se produisent pendant le traitement de la demande, l'application doit passer aussi peu de temps que possible dans le rappel d'empêcher la dégradation du débit de données au réseau. Par exemple, la mise en haut de la boîte de dialogue dans un rappel peut être une exécution longue si le serveur effectue la demande.
Le rappel d'état ne peut pas être supprimé tant que toutes les rappels sont en attente.
Pour exécuter toutes les opérations de façon asynchrone, vous devez créer votre propre thread ou utiliser les fonctions WinInet sans MFC.
Exceptions
Cette méthode peut lever des exceptions de type CInternetException*.
Configuration requise
Header: afxinet.h