Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
unsigned int db_string_ping_server( SQLCA * sqlca, char * connect_string, unsigned int connect_to_db );
sqlca SQLCA 構造体へのポインター。
connect_string connect_string は、通常の接続文字列です。サーバーとデータベースの情報を含んでいる場合もあれば、含んでいない場合もあります。
connect_to_db connect_to_db が 0 以外 (TRUE) なら、この関数はサーバー上のデータベースに接続を試みます。TRUE を返すのは、接続文字列で指定したサーバー上の指定したデータベースに接続できた場合のみです。
connect_to_db が 0 なら、関数はサーバーの検索を試みるだけです。TRUE を返すのは、接続文字列でサーバーを検索できた場合のみです。データベースには接続を試みません。
サーバーまたはデータベースを正常に検索できた場合は TRUE (0 以外)、検索できなかった場合は FALSE (0)。サーバーまたはデータベースの検索に対するエラー情報は SQLCA に返されます。
この関数は、サーバーの検索が可能かどうかを判断するために使用され、オプションで、データベースへの正常な接続が実行できるかどうかを判断するために使用されます。
構文