指定した別名テーブルに関連付けられている言語コードの配列とその配列内の言語コードの数が戻されます。
構文
ESS_FUNC_M
EssOtlGetAliasTableLanguages
(
hOutline
,
pszAliasTable
,
pulCount
,
ppLangArray
);
| パラメータ | データ型 | 説明 |
|---|---|---|
hOutline |
ESS_HOUTLINE_T |
アウトラインのハンドル。 |
pszAliasTable |
ESS_STR_T |
関連付けられている言語コードを取得する別名テーブル名。 |
pulCount |
ESS_PULONG_T |
別名テーブルに関連付けられた言語コードの数が戻される変数のアドレス。 |
ppLangArray |
ESS_PPALIASLANG_T |
pszAliasTableで指定された別名テーブルに関連付けられている言語コードの配列。 ppLangArrayに対して割り当てられているメモリーは、EssFree()を使用して解放する必要があります。 |
戻り値
成功の場合、0が戻されます。
処理に失敗すると、エラーOTLAPI_BAD_ALIASTABLE (無効な別名テーブル)が戻されます。
アクセス
この関数を使用するのに、特別な権限は必要ありません。
例
#include <essapi.h>
#include <essotl.h>
ESS_STS_T sts = 0;
ESS_OUTLINEINFO_T NewInfo;
ESS_HOUTLINE_T hOutline;
ESS_PALIASLANG_T pLangs=ESS_NULL;
ESS_ULONG_T nLangs = 0, i=0;
memset(&NewInfo, '\0', sizeof(NewInfo));
sts = EssOtlNewOutline(hCtx, &NewInfo, &hOutline);
if (!sts)
{
sts = EssOtlCreateAliasTable(hOutline,
"French Alias Table");
}
if (!sts)
{
sts = EssOtlSetAliasTableLanguage (hOutline,
"French Alias Table", "fr");
}
if (!sts)
{
sts = EssOtlSetAliasTableLanguage (hOutline,
"French Alias Table", "fr-CA");
}
if (!sts)
{
sts = EssOtlGetAliasTableLanguages(hOutline, "French Alias Table", &nLangs, &pLangs);
if ( !sts == ESS_STS_NOERR && ( pLangs) )
{
for (i=0;i<nLangs ;++i)
{
if (pLangs[i])
{
printf("Language Code: %s\n", pLangs[i]);
}
}
EssFree(hInst, pLangs);
}
}
if (!sts)
{
sts = EssOtlClearAliasTableLanguages (hOutline,
"French Alias Table");
}
関連トピック