VCINSTALLDIR 環境変数に Visual C++ インストール環境のルートフォルダーを設定します (変数がまだ存在しない場合)。

%VCINSTALLDIR%\VC\atlmfc\src\atl を INCLUDE 環境変数に追加します。

このチュートリアルで作成されるファイルを保存するフォルダーを作成します。

以降、このチュートリアルではこのフォルダーが C:\tutorial\cpp\ であることを前提に説明します。別の名前のフォルダーを作成した場合は、C:\tutorial\cpp\ の代わりにそのフォルダーを使用してください。

Sybase Central で Ultra Light を使用して、デフォルトの特性を持つデータベース ULCustomer.udb を新しいフォルダーに作成します。

ULCustomer という名前のテーブルをデータベースに追加します。次の ULCustomer テーブル仕様を使用します。

Sybase Central でデータベースから切断します。そうしないと、実行ファイルが接続できません。

Microsoft Visual C++ で、[ファイル] » [新規作成] をクリックします。

[ファイル] タブで、[C++ ソース ファイル] をクリックします。

チュートリアルのフォルダーに、そのファイルを customer.cpp として保存します。

Ultra Light ライブラリをインクルードします。

以下のコードを customer.cpp にコピーします。

#include <tchar.h>
#include <stdio.h>
#include "ulcpp.h"
#define MAX_NAME_LEN 100

データベースに接続するための接続パラメーターを定義します。

次のコードでは、接続パラメーターはハードコードされています。実際のアプリケーションでは、ロケーションは実行時に指定されることもあります。

以下のコードを customer.cpp にコピーします。

static ul_char const * ConnectionParms =
    "UID=DBA;PWD=sql;DBF=C:\\tutorial\\cpp\\ULCustomer.udb";

アプリケーションでデータベースエラーを処理するメソッドを定義します。

Ultra Light は、アプリケーションにエラーを通知するためのコールバックメカニズムを備えています。開発環境において、このメソッドは予期しないエラーを処理するメカニズムとして便利です。運用アプリケーションには、あらゆる一般的なエラー状況を処理するコードが含まれているのが普通です。アプリケーションでは、Ultra Light メソッドを呼び出すごとにエラー確認するか、エラーコールバック関数を使用するかを選択します。

コールバック関数のサンプルコードを次に示します。

ul_error_action UL_CALLBACK_FN MyErrorCallBack(
    const ULError *  error,
    ul_void *        user_data )
{
    ul_error_action rc;
    an_sql_code code = error->GetSQLCode();
    
    (void) user_data;

    switch( code ){
        // The following error is used for flow control - don't report it here
        case SQLE_NOTFOUND:
            rc = UL_ERROR_ACTION_CONTINUE;  
        break;

        default:
            if (code >= 0) { // warning or success
                rc = UL_ERROR_ACTION_DEFAULT; 
            } else { // negative is real error
                ul_char etext[ MAX_NAME_LEN ];
                error->GetString( etext, MAX_NAME_LEN );
                _tprintf( "Error %ld: %s\n", code, etext );
                rc = UL_ERROR_ACTION_CANCEL;
            }
        break;
     }
    return rc;
 }

Ultra Light では、ほとんどの場合はエラー SQLE_NOTFOUND を使用してアプリケーションのフローを制御しています。このエラーが通知されると、結果セットのループの終了がマークされます。上記の汎用エラーハンドラーは、このエラー条件に対してはメッセージを出力しません。

データベースの接続を開くメソッドを定義します。

データベースファイルがなかった場合は、エラーメッセージが表示されます。そうでない場合は、接続が確立されます。

static ULConnection * open_conn( void ) 
{
    ULConnection * conn = ULDatabaseManager::OpenConnection( ConnectionParms );
    if( conn == UL_NULL ) {
      _tprintf("Unable to open existing database.\n");
   }
  return conn;
}

次のタスクを実行する main メソッドを実装します。

int main() {
    ULConnection *	conn;

    ULDatabaseManager::Init();  
    ULDatabaseManager::SetErrorCallback( MyErrorCallBack, NULL );

    conn = open_conn();
    if ( conn == UL_NULL ) {
        ULDatabaseManager::Fini();
        return 1;  
    }

    // Main processing code goes here ...
    do_insert( conn );
    do_select( conn );
    do_sync( conn );

    conn->Close();
    ULDatabaseManager::Fini();
    return 0;
}

ソースファイルのコンパイルとリンクを行います。

ソースファイルのコンパイル方法は、コンパイラーによって異なります。以下の手順は、makefile で Microsoft Visual C++ コマンドラインコンパイラーを使用する場合です。

アプリケーションを実行します。

コマンドプロンプトで customer と入力します。

アプリケーションがデータベースに接続したら、切断します。エラーメッセージが表示されなければ、アプリケーションは正常に実行されています。