WillConnect イベント (ADO)WillConnect Event (ADO)

WillConnectの接続を開始する前に、イベントが呼び出されます。The WillConnect event is called before a connection starts.

適用対象します。 Connection オブジェクト (ADO)Applies To: Connection Object (ADO)

構文Syntax

  
WillConnect ConnectionString, UserID, Password, Options, adStatus, pConnection  

パラメーターParameters

ConnectionStringConnectionString
A文字列保留中の接続の接続情報を格納します。A String that contains connection information for the pending connection.

UserIDUserID
A文字列保留中の接続のユーザー名を格納しています。A String that contains a user name for the pending connection.

PasswordPassword
A文字列保留中の接続のパスワードを格納しています。A String that contains a password for the pending connection.

[オプション]Options
A長いプロバイダーを評価する方法を示す値、 ConnectionStringします。A Long value that indicates how the provider should evaluate the ConnectionString. 唯一の選択肢はadAsyncOpenします。Your only option is adAsyncOpen.

adStatusadStatus
EventStatusEnum状態値。An EventStatusEnum status value.

このパラメーターに設定されているこのイベントが呼び出されると、 adStatusOK既定。When this event is called, this parameter is set to adStatusOK by default. 設定されているadStatusCantDeny場合は、イベントが保留中の操作のキャンセルを要求できません。It is set to adStatusCantDeny if the event cannot request cancellation of the pending operation.

このイベントから制御が戻る前に、このパラメーターを設定adStatusUnwantedEvent後続通知しないように設定します。Before this event returns, set this parameter to adStatusUnwantedEvent to prevent subsequent notifications. このパラメーターに設定adStatusCancelこの通知の取り消しの原因となった接続操作を要求します。Set this parameter to adStatusCancel to request the connection operation that caused cancellation of this notification.

pConnectionpConnection
接続オブジェクトをこのイベント通知が適用されます。The Connection object for which this event notification applies. パラメーターへの変更、接続によって、 WillConnectイベント ハンドラーは効果がありません、接続します。Changes to the parameters of the Connection by the WillConnect event handler will have no effect on the Connection.

コメントRemarks

ときにWillConnectが呼び出される、 ConnectionStringUserIDパスワード、およびオプションパラメーターは、(保留中の接続)、このイベントの原因し、イベントを返します。 前に変更することができる操作によって確立されている値に設定されます。When WillConnect is called, the ConnectionString, UserID, Password, and Options parameters are set to the values established by the operation that caused this event (the pending connection), and can be changed before the event returns. WillConnect保留中の接続をキャンセルする要求を返す可能性があります。WillConnect may return a request that the pending connection be canceled.

このイベントが取り消されると、 ConnectComplete呼び出しに使用されるそのadStatusパラメーターに設定adStatusErrorsOccurredします。When this event is canceled, ConnectComplete will be called with its adStatus parameter set to adStatusErrorsOccurred.

関連項目See Also

ADO イベント モデルの例 (vc++) ADO Events Model Example (VC++)
ADO イベント ハンドラーの概要ADO Event Handler Summary