PFAXSTARTPRINTJOBA

BOOL PFAXSTARTPRINTJOBA(
    LPSTR PrinterName,
    FAX_PRINT_INFOA* PrintInfo,
    DWORD* FaxJobId,
    FAX_CONTEXT_INFOA* FaxContextInfo
);

ファックス クライアント アプリケーションは、指定したファックス プリンターで送信ファックスの印刷を開始するために FaxStartPrintJob 関数を呼び出します。

型: BOOL

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

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

戻り値	説明
ERROR_INVALID_PARAMETER	PrintInfo または FaxContextInfo パラメーターの一方、または両方が NULL です。
ERROR_INVALID_PARAMETER	FAX_PRINT_INFO 構造体の RecipientNumber メンバーが NULL です。または、OutputFileName メンバーが NULL で、かつ RecipientNumber メンバーが指定されていません。
ERROR_INVALID_PRINTER_NAME	PrinterName パラメーターに、ファックス プリンターではないプリンターが指定されているか、ファックス プリンターがインストールされていません。
ERROR_NOT_ENOUGH_MEMORY	メモリの割り当て中にエラーが発生しました。
ERROR_SPL_NO_STARTDOC	FaxStartPrintJob が先に呼び出されていないため、StartDoc の呼び出しが行われていません。

この関数はデバイス コンテキストのハンドルを返します。このハンドルは、FaxPrintCoverPage 関数のほか、AbortDoc、EndDoc、DeleteDC、StartPage、EndPage などの Win32 Windows Graphics Device Interface (GDI) 関数で使用されます。

ファックス クライアント アプリケーションは、ファックス プリンターのデバイス コンテキストを作成するために GDI の CreateDC 関数を呼び出してはなりません。また、ファックス印刷ジョブを開始するために StartPage 印刷関数を呼び出してもなりません。代わりに、FaxStartPrintJob 関数を呼び出してください。これは、FaxStartPrintJob が対象のファックス プリンターに固有の DEVMODE 構造体の情報を変更するためです。

この変更により、ユーザーから情報を収集するファックス送信ウィザードが表示されなくなります。ファックス サーバーは、PrintInfo パラメーターが指す FAX_PRINT_INFO 構造体のデータを使用してファックス送信を印刷します。この構造体には、ファックス送信ウィザードが表示されていれば収集されたはずのデータが含まれます。

ファックス クライアント アプリケーションは、ファックス ジョブと共にカバー ページを印刷するために FaxPrintCoverPage 関数を呼び出す前に、FaxStartPrintJob 関数を呼び出す必要があります。