EsbPutObject

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

構文

            EsbPutObject
             (
            hCtx, ObjType, AppName, DbName, ObjName, LocalName, isUnlock
            )
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 
            isUnlock
              As Integer
         
パラメータ説明

hCtx

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

ObjType

オブジェクト・タイプ(単一のタイプのみ)。使用可能な値のリストは、表 15を参照してください。

AppName

アプリケーション名。

DbName

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

ObjName

配置するオブジェクト名。

LocalName

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

isUnlock

オブジェクトのロック解除を制御するフラグ。TRUEの場合、サーバー・オブジェクトのロックが解除され、他のユーザーによる更新が許可されます。

備考

サーバー上に存在しているオブジェクトを配置するには、呼出し元によって事前にロックされている必要があります。オブジェクトがサーバー上になければ、新規作成されます。

戻り値

正常終了の場合は、オブジェクトがLocalNameで指定したローカル・ファイルからサーバーにコピーされます。

アクセス

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

         Declare Function EsbPutObject 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 Unlock As Integer) As Long

Sub ESB_PutObject ()
   Dim sts As Long
   Dim AppName As String
   Dim DbName As String
   Dim ObjName As String
   Dim ObjType As Integer
   Dim LocalName As String
   Dim Unlock As Integer   AppName = "Sample"
   DbName = "Basic"
   ObjName = "Basic"
   ObjType = ESB_OBJTYPE_TEXT
   LocalName = "C:\ESSBASE\CLIENT\BASIC.TXT" 
   Unlock = ESB_YES   '***********
   ' Put Object 
   '***********
   sts = EsbPutObject (hCtx, ObjType, AppName,
         DbName, ObjName, LocalName, Unlock) 
End Sub
      

関連トピック