PFAXSTARTPRINTJOBW

BOOL PFAXSTARTPRINTJOBW(
    LPWSTR PrinterName,
    FAX_PRINT_INFOW* PrintInfo,
    DWORD* FaxJobId,
    FAX_CONTEXT_INFOW* 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 グラフィックスデバイスインターフェイス (GDI) 関数で使用されます。

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

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

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