EssGBeginLock

この関数はデータベースのブロックをロックします。

構文

            ESSG_FUNC_M 
            EssGBeginLock
             (
            hGrid, ulOptions
            );

パラメータ	データ型	説明
hGrid	ESSG_HGRID_T	EssGNewGridから戻されるハンドル。
ulOptions	ESSG_ULONG_T	今後使用するために予約されています。ゼロに設定する必要があります。

備考

ulOptionsパラメータにESSG_RET_LOCKONLYを指定してEssGRetrieve関数を呼び出す場合と同一の機能を果します。
呼出し元にはデータが戻されません。
この操作では、行を取得する必要はありません。EssGSendRowsとEssGPerformOperationを呼び出すのみで十分です。

戻り値

正常終了の場合は、ESSG_STS_NOERRが戻されます。

アクセス

なし。

例

         ESSG_VOID_T ESSG_BeginLock (ESSG_HGRID_T hGrid)

{
  ESSG_FUNC_M    sts = ESS_STS_NOERR;
  ESSG_PPDATA_T        ppDataIn;
  ESSG_RANGE_T         rDataRangeIn;
  ESSG_ULONG_T         ulOptions;

     /* connect the grid to a database on the server */
     sts = EssGConnect(hGrid, "Rainbow", "Admin", 
           "Password", "Demo", "Basic", 
           ESSG_CONNECT_DEFAULT);
   
  if(sts == 0)
  {
     ppDataIn = BuildTable(&rDataRangeIn); 
      
     /* start the lock operation */
     ulOptions = 0;
     sts = EssGBeginLock(hGrid, ulOptions);
  }

  if(sts == 0)
  {
     /* send the entire grid to define the query */
     sts = EssGSendRows(hGrid, &rDataRangeIn,       
           ppDataIn);
  }

  if(sts == 0)
  {
     /* perform the lock operation */
     sts = EssGPerformOperation(hGrid, 0);

     /* Free the built data */
     FreeTwoDim(ppDataIn, rDataRangeIn.ulNumRows);
  }
       
  if(!sts)
  {
     EssGEndOperation(hGrid, 0);
     EssGDisconnect(hGrid, 0);
  }
}