EsbGetObject

サーバーまたはクライアントのオブジェクト・システムからローカル・ファイルにオブジェクトをコピーし、オプションでロックします。

構文

            EsbGetObject
             (
            hCtx, ObjType, AppName, DbName, ObjName, LocalName, isLock
            )
ByVal 
            hCtx
                  As Long
ByVal 
            ObjType
               As Long
ByVal 
            AppName
               As String
ByVal 
            DbName
                As String
ByVal 
            objName
               As String
ByVal 
            LocalName
             As String
ByVal 
            isLock
                As Integer
         
パラメータ説明

hCtx

VB APIコンテキスト・ハンドル。EsbCreateLocalContext()によって戻されたローカル・コンテキスト・ハンドルの場合もあります。

ObjType

オブジェクト・タイプ(単一のタイプのみ)。ビットマスク・データ型に関する説明を参照してください。

AppName

アプリケーション名。

DbName

データベース名。空の文字列の場合は、アプリケーションのサブディレクトリが使用されます。

ObjName

取得するオブジェクト名。

LocalName

クライアント上のローカル・コピー先ファイルのフル・パス名。

isLock

オブジェクトのロックを制御するフラグ。TRUEの場合は、オブジェクトがロックされ、他のユーザーによる更新を防止します。

備考

オブジェクトをロックするには、そのオブジェクトがサーバーに存在している必要があり、かつ他のユーザーによってロックされていないことが必要です。クライアント上でのロックはサポートされていません。

戻り値

正常終了の場合は、オブジェクトはLocalNameで指定されているローカル・ファイルにコピーされます。

アクセス

この関数を使用するには、呼出し元は、オブジェクトがある指定したコピー元アプリケーションまたはデータベース(あるいはその両方)に対して、適切なレベルのアクセス権(オブジェクト・タイプによって異なる)を持っている必要があります。オブジェクトをロックするには(ロック・フラグがTRUE)、呼出し元は、指定したコピー先アプリケーション、またはオブジェクトが含まれているデータベースに対して、アプリケーションまたはデータベース・マネージャの権限(ESB_PRIV_APPDESIGNまたはESB_PRIV_DBDESIGN)を持っている必要があります。

         Declare Function EsbGetObject Lib "ESBAPIN" (ByVal hCtx As Long, ByVal ObjType As Integer, ByVal AppName As String, ByVal DbName As String, ByVal ObjName As String, ByVal LocalName As String, ByVal Lock As Integer)
 As Long
 
 Sub ESB_GetObject ()
   Dim sts As Long
   Dim AppName As String
   Dim DbName As String
   Dim ObjName As String
   Dim ObjType As Long
   Dim LocalName As String
   Dim Lock As Integer   AppName = "Sample"
   DbName = "Basic"
   ObjName = "Basic"
   ObjType = ESB_OBJTYPE_OUTLINE
   LocalName = "C:\ESSBASE\CLIENT\BASIC.OTL" 
   Lock = ESB_YES   '***********
   ' Get Object 
   '***********
   sts = EsbGetObject (hCtx, ObjType, AppName,
         DbName, ObjName, LocalName, Lock) 
End Sub
      

関連トピック