付録G.2 dbrinitSession

機能
UOCセッションの初期化
形式

int *dbrinitSession(
    void          *pvhLibrary,     /* UOCライブラリハンドル */
    const char    *pszUserName,    /* ログインユーザ名        */
    char          *pszErrMessage   /* エラーメッセージ        */
)

機能説明
UOCセッションを初期化します。この関数は,セッション作成時にセッション内で1回だけ発行されます。初期化が正常に終了した場合,UOCセッションハンドルを返却します。
引数
pvhLibrary(入力)
ライブラリ固有のハンドルを指定します。このパラメタにはdbrinitLibrary()で返却された値を指定してください。
pszUserName(入力)
CdbrSession::Connect()で指定されたユーザ名を指定します。NULLまたは""(空文字列)が指定された場合,エラーになります。
pszErrMessage(出力)
エラーが発生した場合,エラーの詳細を示すメッセージの格納領域を指定します。メッセージの格納領域は,1,024バイト以上を確保しておく必要があります。この引数にNULLを指定した場合,詳細を示すメッセージは返却されません。
戻り値

non NULL      UOCライブラリハンドル
NULL          初期化に失敗しました

注意事項
この関数は,マルチスレッド環境で発行されます。そのため,スレッドセーフにしておく必要があります。