新規にロケーション別名を作成します。つまり、別名の文字列を、次の5個の文字列が順に並んだ形式へマッピングします。5個の文字列とは: ホスト名、アプリケーション名、データベース名、ユーザー・ログイン名、ユーザー・パスワードです。
構文
ESS_FUNC_M EssCreateLocationAlias ( hCtx , pAlias , pHost , pApp , pDb , pName , pPassword );
パラメータ | データ型 | 説明 |
---|---|---|
hCtx; |
ESS_HCTX_T |
APIコンテキスト・ハンドル。 |
pAlias; |
ESS_STR_T |
ロケーション別名。 |
pHost; |
ESS_STR_T |
ターゲット・ホスト。 |
pApp; |
ESS_STR_T |
ターゲット・アプリケーション。 |
pDb; |
ESS_STR_T |
ターゲット・データベース。 |
pName; |
ESS_STR_T |
ユーザー・ログイン名。 |
pPassword; |
ESS_STR_T |
ユーザー・パスワード。 |
戻り値
pAliasと同じ名前のロケーション別名がすでに存在する場合は、エラーが戻されます。
関連トピック