CInternetSession::EnableStatusCallback

BOOL EnableStatusCallback (BOOL bActivez = TRUE) ;
Jeter (CInternetException);

Valeur de retour

Différent de zéro en cas de succès ; sinon 0. Si l'appel échoue, déterminer la cause de l'échec en examinant l'objet CInternetException levée.

Paramètres

bActivez

Spécifie si le rappel est activée ou désactivée. La valeur par défaut est TRUE.

Remarques

Appelez cette fonction membre pour permettre le rappel de la situation. Lors de la manipulation de rappel de la situation, vous pouvez fournir l'état de l'avancement de l'opération (comme la résolution de nom, de se connecter au serveur et ainsi de suite) dans la barre d'État de l'application. Afficher l'état de l'opération est particulièrement souhaitable au cours d'une opération à long terme.

Vous pouvez définir une routine de rappel pour les opérations synchrones ; Cependant, vous devez établir une routine de rappel pour les opérations asynchrones car l'API asynchrone fait un rappel avec INTERNET_STATUS_REQUEST_COMPLETE pour indiquer que la demande est terminée.

Il sera un rappel pour une opération asynchrone sur un thread autre que celui de la demande originale. L'appel peut échouer avec une erreur ERROR_IO_PENDING si la demande n'est pas complète lorsque le rappel de la situation se produit. Le rappel peut être intitulé dans un contexte de thread différent du thread qui a lancé la demande.

Parce que les rappels se produisent pendant le traitement de la demande, la demande devrait passer en peu de temps que possible dans le rappel pour prévenir la dégradation du débit des données sur le réseau. Par exemple, mettre une boîte de dialogue dans un rappel peut être telle une longue opération que le serveur met fin à la demande.

Le rappel de l'État ne peut être enlevé aussi longtemps que des rappels ou des fonctions asynchrones sont en attente.

&Notenbsp ;  Pour gérer toute opération de façon asynchrone, vous doivent attribuer trois conditions:

• Dans le constructeur, dwFlags doit inclure des INTERNET_FLAG_ASYNC.
  
  
• Dans le constructeur, dwContext doit être définie à 1.
  
  
• Vous devez établir une fonction retour d'appel en appelant le EnableStatusCallback.

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::CInternetSession