IFaxServer::CreateDocument メソッドは、指定された FaxServer オブジェクトの FaxDoc オブジェクトを作成します。 FaxDoc オブジェクトを使用すると、ユーザーはドキュメントを作成し、1 人以上の FAX 受信者に送信できます。
構文
HRESULT CreateDocument(
[in] BSTR FileName,
[out] VARIANT *retval
);
パラメーター
[in] FileName
種類: BSTR
送信する FAX ドキュメントを含むファイルの完全修飾パスと名前を含む null で終わる文字列を指定します。 パスには、UNC パスまたはドライブ文字で始まるパスを指定できます。
このパラメーターには、任意の有効なローカルまたはリモート のファイル名を含めることができます。 ファイルは正しく登録されているファイルの種類である必要があり、FAX サーバーはファイルにアクセスできる必要があります。
[out] retval
型: VARIANT*
FAXDoc オブジェクトへの IDispatch インターフェイス ポインターを受け取る VARIANT 構造体へのポインター。 メソッドは、VT_DISPATCHデータ型を持つ pdispVal メンバーを返します。
戻り値
種類: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
IFaxServer::CreateDocument メソッドは、FaxDoc オブジェクトへの IDispatch インターフェイス ポインターを取得します。 FAX クライアント アプリケーションは、IUnknown::QueryInterface メソッドを呼び出してインターフェイス ポインターを取得することで、IFaxDoc インターフェイスに直接アクセスすることもできます。 IFaxDoc インターフェイスを使用すると、ユーザーは FAX ドキュメントのプロパティを設定し、ドキュメントを送信できます。
FAX クライアント アプリケーションは、正しくインスタンス化されないため、 CoCreateInstance 関数を呼び出して IFaxDoc インターフェイス ポインターを取得しないでください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | faxcom.h |
| [DLL] | Faxcom.dll |