Word Automation Services で固定形式のエクスポート機能を拡張する

[アーティクル]
03/21/2023

Microsoft Office 2013 の Word Automation Services を拡張し、固定形式エクスポート機能で使用されるライブラリを置き換えます。

Word ファイル変換サービスの固定形式エクスポート機能の概要

この記事では、Microsoft から提供される固定形式エクスポート DLL をサードパーティの開発者が置き換えられるように、Word Automation Services の固定形式エクスポート機能を拡張して別の固定形式エクスポート DLL を使用する方法を説明します。これを行うには、Office クライアント固定形式拡張 COM インターフェイスを拡張する必要があります。詳細については、「 Office (2007) 固定形式エクスポート機能の拡張」を参照してください。

検出

Word Automation Services を使用すると、サードパーティの開発者はサポートされている次の固定形式の出力のどちらかまたは両方を置き換えることができます。

各形式を置き換えるには、DLL を Word Automation Services のコアライブラリ (Sword.dll) と同じディレクトリ (インストールパス: root\WebServices\ConversionService\Bin\Converter) に配置し、表 1 で指定した特定のファイル名を指定する必要があります。

表 1. 固定形式エクスポート DLL のファイル名

フォーマット	ファイル名
PDF	Renderpdf.dll
XPS	Renderxps.dll

初期化

DLL は、次のシグネチャが付いたメソッドをエクスポートする必要があります。

HRESULT HrGetDocExporter (
  IMsoDocExporter **ppimde,
  IMsoServerFileManagerSite *psfms,
  PFNKeepAlive pfnKeepAlive
)

この関数は、以下のセクションで説明する 2 つのインターフェイスとメソッドポインターを提供することを DLL に要求します。関数の呼び出しが失敗した場合、サービスは Microsoft が提供するエクスポーターにフォールバックしません。代わりに、サービスは変換の失敗を報告します。

IMsoDocExporter

IMsoDocExporter インターフェイスは、MSDN に掲載されている既存のインターフェイスと同じものです。詳細については、「 Office (2007) 固定形式エクスポート機能の拡張」を参照してください。前のメソッドの呼び出しが成功すると、このインターフェイスは変換を実行します。前述の記事で説明した要件を超えて、固定形式のエクスポート DLL の開発者は、サービスが HrGetDocExporter と呼ばれるスレッドとは異なるスレッドで、指定された IMsoDocExporter を呼び出すことができることに注意する必要があります。サービスではメッセージポンプが実行されず、マーシャリングされた呼び出しが通過しなくなり (ハングし、その後のエラーが発生するため)、 DLL は、HrGetDocExporter と呼ばれるスレッドへの呼び出しをマーシャリングせずにこれを処理できる必要があります。

IMsoServerFileManagerSite

IMsoServerFileManagerSite インターフェイスは次のように定義されます。

#undef  INTERFACE
#define INTERFACE  IMsoServerFileManagerSite
DECLARE_INTERFACE(IMsoServerFileManagerSite)
{
  STDMETHOD_(BOOL, FGetHandle) (const WCHAR *pwzFileName, HANDLE *phFile, BOOL fRead, BOOL fWrite) PURE;
  STDMETHOD_(BOOL, FCloseHandle) (HANDLE hFile) PURE;
};

このインターフェイスは次のメソッドを公開します。

表 2. IMsoServerFileManagerSite インターフェイスによって公開されるメソッド**

メソッド	説明
FGetHandle	ファイルハンドルを取得します。
FCloseHandle	ファイルハンドルを解放します。

このインターフェイスは IUnknown を継承しません。したがって、固定形式エクスポート DLL は存続期間中、このインターフェイスへの参照を保持できます。

FGetHandle

固定形式のエクスポート DLL では、この関数を呼び出して、書き込むファイルハンドルを取得します。サービスは、ファイルシステム内のほとんどの場所にアクセスすることなく、高度に制限された環境で実行されるため、他のメカニズムを介してファイルを開こうとしないでください。

BOOL FGetHandle (
  const WCHAR *pwzFile,
  HANDLE *phFile,
  BOOL fRead,
  BOOL fWrite
)

表 3. FGetHandle パラメーター**

パラメーター	説明
pwzFile	固定形式エクスポート DLL が開くファイルの名前を指定します。完全なファイルパスではなく、ファイル名のみを指定する必要があります (例: Output.pdf)。
phFile	ファイルが正常に開いた場合に、指定したファイルのハンドルを指定します。これにより、固定形式エクスポート DLL は FCloseHandle メソッドを呼び出してファイルを閉じるまで、この HANDLE を通常のファイル操作で使用できるようになります。
fRead	ファイルを読み取りアクセス権付きで開くかどうかを指定します。
fWrite	ファイルを書き込みアクセス権付きで開くかどうかを指定します。成功した場合は TRUE が返り、失敗した場合は FALSE が返ります。

FCloseHandle

固定形式エクスポート DLL はこの関数を呼び出して、 FGetHandle メソッドの呼び出しによって取得したファイルハンドルを閉じます。

BOOL FCloseHandle (
  HANDLE phFile,
)

phFile パラメーターは、閉じるファイルのハンドルを指定します。このメソッドによって返された値が 0 の場合、処理は失敗です。それ以外の値の場合は成功です。

PFNKeepAlive

固定形式のエクスポート DLL がアクティブなときは、この DLL が応答していないとサービスが判断してプロセスを終了することがないように、KeepAlive 関数を (管理者が構成する) 一定の間隔で呼び出す必要があります。 typedef void (*PFNKeepAlive)(void)

次の方法で共有