特定のアプリケーションおよびデータベースに接続されているユーザーをすべてリストします。その際、現在ロックされているデータ・ブロックのアイテムも一緒にリストします。
構文
EsbListLocks
(
hCtx, AppName, DbName, pItems
)
ByVal
hCtx
As Long
ByVal
AppName
As String
ByVal
DbName
As String
pItems
As Integer
| パラメータ | 説明 |
|---|---|
hCtx |
VB APIコンテキスト・ハンドル。 |
AppName |
アプリケーション名。 |
DbName |
データベース名。 |
pItems |
ユーザーのアイテムを受け取る変数のアドレス。 |
備考
この関数は、この関数が呼び出されたときにサーバーに接続していたユーザーのみがリストされる場合に「スナップショット」になります。
戻り値
正常終了の場合は、接続されているユーザー数のアイテムがpItemsに戻され、EsbGetNextItem()を介してアクセス可能なユーザー・ロック構造体のリストが生成されます。
アクセス
この関数を使用するには、指定したデータベースに対して、呼出し元がデータベース・デザイン権限(ESB_PRIV_DBDESIGN)を持っている必要があります。
例
Declare Function EsbListLocks Lib "ESBAPIN" (ByVal hCtx As Long, ByVal AppName As String, ByVal DbName As String, Items As Integer) As Long
Sub ESB_ListLocks ()
Dim Items As Integer
Dim AppName As String
Dim DbName As String
Dim LockInfo As ESB_LOCKINFO_T
Dim sts As Long AppName = "Sample"
DbName = "Basic" '***********
' List Locks
'***********
sts = EsbListLocks (hCtx, AppName, DbName,
Items) For n = 1 To Items '*****************************
' Get next user lock structure
' from the list
'*****************************
sts = EsbGetNextItem (hCtx,
ESB_LOCKINFO_TYPE, LockInfo)
Next
End Sub
関連トピック