PFAXSENDDOCUMENTA

コールバック

シグネチャ

BOOL PFAXSENDDOCUMENTA(
    HANDLE FaxHandle,
    LPSTR FileName,
    FAX_JOB_PARAMA* JobParams,
    FAX_COVERPAGE_INFOA* CoverpageInfo,
    DWORD* FaxJobId
);

パラメーター

フィールド	型	説明
FaxHandle	HANDLE	FaxConnectFaxServer 関数の呼び出しによって返されたファックスサーバーのハンドルを指定します。
FileName	LPSTR	送信するファックス文書が格納されたファイルの完全修飾パスと名前を含む、定数の null 終端文字列へのポインターです。パスには UNC パス、またはドライブ文字で始まるパスを指定できます。このパラメーターには、有効なローカルファイル名を指定できます。ファイルは適切に登録されたファイルの種類であり、かつファックスサーバーがそのファイルにアクセスできる必要があります。
JobParams	FAX_JOB_PARAMA*	ファックスサーバーがファックスを送信するために必要な情報を格納した FAX_JOB_PARAM 構造体へのポインターです。この構造体には、受信者のファックス番号、送信者と受信者のデータ、省略可能な課金コード、ジョブのスケジュール情報などが含まれます。
CoverpageInfo	FAX_COVERPAGE_INFOA*	ファックス文書のカバーページに表示する個人データを格納した FAX_COVERPAGE_INFO 構造体へのポインターです。カバーページが不要な場合、このパラメーターは NULL である必要があります。
FaxJobId	DWORD*	ファックスを送信するキュー内のジョブを識別する一意の番号を受け取る DWORD 変数へのポインターです。

公式ドキュメント

ファックスクライアントアプリケーションは、送信するファックスを伝送するファックスジョブをキューに登録するために FaxSendDocument 関数を呼び出します。

戻り値

型: BOOL

関数が成功すると、0 以外の値を返します。

関数が失敗すると、0 を返します。拡張エラー情報を取得するには、GetLastError を呼び出します。GetLastError は次のいずれかのエラーを返すことがあります。

戻り値	説明
ERROR_INVALID_PARAMETER	FaxHandle、JobParams、FileName の各パラメーターのいずれか、またはすべてが NULL です。FAX_JOB_PARAM 構造体の CallHandle メンバーで指定された呼び出しハンドルが無効です (NULL である必要があります)。または、FAX_JOB_PARAM 構造体の RecipientNumber メンバーが NULL です。
ERROR_INVALID_FUNCTION	FaxHandle パラメーターがリモート接続を指定していますが、FAX_JOB_PARAM 構造体の CallHandle メンバーが NULL ではありません。
ERROR_ACCESS_DENIED	アクセスが拒否されました。FAX_JOB_SUBMIT アクセス権が必要です。
ERROR_FILE_NOT_FOUND	ファックスサーバーが、FileName パラメーターまたは CoverpageInfo パラメーターで指定されたファイルを見つけられません。
ERROR_INVALID_DATA	ファックスサーバーが、FileName パラメーターまたは CoverpageInfo パラメーターで指定されたファイルを処理できません。
ERROR_NOT_SUPPORTED	FAX_JOB_PARAM 構造体の CallHandle メンバーを使用して、音声通話をファックス送信に引き渡そうとしました。この機能はサポートされていません。

解説(Remarks)

FaxSendDocument 関数を呼び出す前に、FaxCompleteJobParams 関数を呼び出してください。FaxCompleteJobParams は、送信者名、ファックス番号、省略可能な課金コード情報などの情報を、FAX_COVERPAGE_INFO 構造体と FAX_JOB_PARAM 構造体の複数のメンバーに設定するユーティリティ関数です。

FaxSendDocument 関数は非同期に実行され、関数はすぐに戻ります。ファックスサーバーは、FAX_JOB_PARAM 構造体で指定された内容に従って、ファックスを送信するジョブをキューに登録します。

FaxSendDocument が成功するには、ファックスサーバーにリモートファックスプリンターがインストールされている必要があります。

ファックス文書を複数の受信者に効率よく送信するには、アプリケーションは FaxSendDocument 関数を複数回呼び出す必要があります。FaxSendDocumentForBroadcast 関数は、下位互換性のためにサポートされています。

アプリケーションから文書を送信するとき、文書内のリンクによって情報の入力を求めるダイアログが表示されることがあります。数分以内にその情報要求を処理しないと、FaxSendDocument は失敗し、エラーを返します。

メモ

winfax.h ヘッダーは、UNICODE プリプロセッサ定数の定義に応じてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして FaxSendDocument を定義しています。エンコードに依存しないこのエイリアスを、エンコードに依存するコードと混在させて使用すると、不一致が生じてコンパイルエラーや実行時エラーの原因になることがあります。詳しくは、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)