EssOtlWriteOutlineEx

既存のアウトライン情報をディスクに書き込み、UTF-8エンコード方式と非Unicodeエンコード方式のどちらで保存するかを指定します。

構文

            
ESS_FUNC_M 
            EssOtlWriteOutlineEx
            (
            hOutline
            , 
            pObject
            , 
            iOtlType
            );

パラメータ	データ型	説明
hOutline	ESS_HOUTLINE_T	アウトラインのコンテキスト・ハンドル。
pObject	ESS_POBJDEF_T	書込み対象のアウトライン・オブジェクト。
iOtlType		アウトラインをUnicodeモードで保存するか非Unicodeモードで保存するか。有効な値は次のとおりです: ESS_OUTLINE_UTF8 0x0002 - UTF-8でエンコードします。 ESS_OUTLINE_NONUNICODE 0x0003 - Unicodeでエンコードしません。

パラメータ

データ型

説明

hOutline

ESS_HOUTLINE_T

アウトラインのコンテキスト・ハンドル。

pObject

ESS_POBJDEF_T

書込み対象のアウトライン・オブジェクト。

iOtlType

アウトラインをUnicodeモードで保存するか非Unicodeモードで保存するか。

有効な値は次のとおりです:

ESS_OUTLINE_UTF8 0x0002 - UTF-8でエンコードします。
ESS_OUTLINE_NONUNICODE 0x0003 - Unicodeでエンコードしません。

備考

アウトラインをサーバー・オブジェクトとして保存する場合、アウトラインは当初.OTNファイルとして保存されます。次にEssOtlRestructure()を呼び出して、実際の.OTLファイルを作成する必要があります。
アウトラインをサーバー・オブジェクトとして保存する場合、オブジェクト名はデータベース名と同じである必要があります。
サーバー・アウトライン・オブジェクトまたはクライアント・アウトライン・オブジェクトをローカル・データベースに保存する場合、データベースがすでに存在している必要があります。
指定されたユーザーによってアウトラインが現在ロックされていない場合、この呼出しは正常に行われません(ESS_OBJDEF_T構造体のhCtxパラメータ)。

戻り値

正常終了の場合は0が戻されます。それ以外の場合は、次のいずれかの値が戻されます:

OTLAPI_BAD_OBJTYPE
OTLAPI_ERR_NOTVERIFIED

アクセス

この関数を使用するには、指定したアプリケーションと、アウトライン・オブジェクトを含むデータベースのいずれか、またはその両方に対して、呼出し元が適切なレベルのアクセス権を持っている必要があります。アウトライン・オブジェクトを書き込むには、指定したアプリケーション、またはアウトラインが含まれたデータベースに対してアプリケーション・デザイナまたはデータベース・デザイナ権限(ESS_PRIV_APPDESIGNまたはESS_PRIV_DBDESIGN)が必要です。