db_get_property 関数

unsigned int db_get_property(
SQLCA * sqlca,
a_db_property property,
char * value_buffer,
int value_buffer_size );

この関数は、接続するデータベース・インタフェースまたはサーバに関する情報を取得するために使用します。

引数は次のとおりです。

a_db_property 要求されるプロパティ。DB_PROP_CLIENT_CHARSET、DB_PROP_SERVER_ADDRESS、または DB_PROP_DBLIB_VERSION のいずれかです。
value_buffer NULL で終了する文字列としてプロパティ値が入ります。
value_buffer_size 末尾の NULL 文字を含む、文字列 value_buffer の最大長。

次のプロパティがサポートされます。

DB_PROP_CLIENT_CHARSET このプロパティ値はクライアントの文字セットを取得します ("windows-1252" など)。
DB_PROP_SERVER_ADDRESS このプロパティ値は、現在の接続のサーバ・ネットワーク・アドレスを印刷可能な文字列として取得します。共有メモリ・プロトコルは、アドレスに対して必ず空の文字列を返します。TCP/IP プロトコルは、空でない文字列アドレスを返します。
DB_PROP_DBLIB_VERSION このプロパティ値は、データベース・インタフェース・ライブラリのバージョンを取得します ("11.0.0.1297" など)。

正常終了すると 1 を返し、それ以外は 0 を返します。