CDatabase::OnSetOptions

virtuel void OnSetOptions ( HSTMT hstmt );

Paramètres

hstmt

Le handle d'instruction ODBC pour lesquelles options sont définies.

Remarques

Le framework appelle cette fonction membre lorsque directement à l'exécution d'une instruction SQL avec la fonction membre ExecuteSQL . CRecordset::OnSetOptions appelle également cette fonction membre.

OnSetOptions définit la valeur de délai d'attente de connexion. Si il y a eu des appels précédents à la fonction SetQueryTimeout et membre, OnSetOptions reflète les valeurs actuelles ; sinon, il définit les valeurs par défaut.

&Notenbsp ;  Avant de MFC 4.2, OnSetOptions également définir le mode de traitement asynchrone ou soit snychronous. Commençant avec MFC 4.2, toutes les opérations sont synchrones. Pour exécuter une opération asynchrone, vous devez effectuer un appel direct à la fonction API ODBC SQLSetPos.

Vous n'avez pas besoin de substituer OnSetOptions pour modifier la valeur de délai d'attente. Au lieu de cela, pour personnaliser la valeur de délai d'attente de requête, appeler SetQueryTimeout avant de créer un jeu d'enregistrements ; OnSetOptions utilisera la nouvelle valeur. L'ensemble de valeurs s'appliquent aux opérations ultérieures sur tous les Jeux d'enregistrements ou appels SQL directs.

Substituez OnSetOptions si vous souhaitez définir des options supplémentaires. Votre priorité devrait appeler la classe de base OnSetOptions soit avant ou après que vous appelez la fonction API ODBC :: SQLSetStmtOption. Suivez la méthode illustrée dans l'implémentation par défaut du cadre de OnSetOptions.

Aperçu de l'objet CDatabase |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CDatabase::ExecuteSQL, CDatabase::SetQueryTimeout, CRecordset::OnSetOptions

Index