PFAXCLOSE

FaxClose 関数は、次の種類のファックスハンドルを閉じます。

• FaxConnectFaxServer 関数の呼び出しによって返されたファックスサーバーハンドル
• FaxOpenPort 関数の呼び出しによって返されたファックスポートハンドル

Type: BOOL

関数が成功した場合、戻り値は 0 以外の値です。

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

ファックスクライアントアプリケーションは、終了する前の最後の関数として FaxClose 関数を呼び出す必要があります。CloseHandle 関数では、ファックスサーバーやファックスポートのハンドルを閉じることはできません。

FaxClose 関数が FaxConnectFaxServer 関数によって割り当てられたハンドルを閉じると、この関数は呼び出し元のアプリケーションを指定されたファックスサーバーから切断します。

ファックスクライアントアプリケーションは、FaxClose 関数を呼び出してファックスサーバーハンドルを正常に閉じた後も、ファックスサービスからファックスイベントを受信し続けます。これにより、サービスが長時間アイドル状態のときにファックスサービスをシャットダウンさせ、システムリソースを節約できます。ファックスサーバーへのハンドルを開いたままにしておくと、ファックスサービスはシャットダウンしません。

詳細については、Enabling an Application to Receive Notifications of Fax Events、Connecting to a Fax Server および Disconnecting from a Fax Server、FaxInitializeEventQueue を参照してください。