アクティブなデータベースのすべての別名テーブルを完全に削除します。
構文
ESS_FUNC_M EssClearAliases (
hCtx
);
パラメータ | データ型 | 説明 |
---|---|---|
hCtx |
ESS_HCTX_T |
APIコンテキスト・ハンドル。 |
備考
この関数は、アクティブな別名テーブルもデフォルトの別名テーブルも削除できません。
このAPI関数を使用する前に、EssSetAliasを使用してアクティブな別名を"default"に設定します。
EssListConnectionsを呼び出して、別名テーブルを消去しようとしているデータベースが他のユーザーによって使用されていないことを確認します。
戻り値
なし。
アクセス
この関数を使用するには、呼出し元がデータベースに対して少なくとも読取りアクセス権(ESS_PRIV_READ)を持っていて、EssSetActiveを使用してそのデータベースをアクティブなデータベースとして選択している必要があります。
例
ESS_FUNC_M ESS_ClearAliases (ESS_HCTX_T hCtx) { ESS_FUNC_M sts = ESS_STS_NOERR; sts = EssClearAliases(hCtx); if(!sts) printf("All alias tables are removed.\r\n"); return (sts); }
関連トピック