PFAXOPENPORT

BOOL PFAXOPENPORT(
    HANDLE FaxHandle,
    DWORD DeviceId,
    DWORD Flags,
    HANDLE* FaxPortHandle
);

FaxOpenPort 関数は、ファクスポートのハンドルをファクスクライアントアプリケーションに返します。このポートハンドルは、デバイス管理やファクスドキュメントのルーティングを行う他のファクスクライアント関数をアプリケーションが呼び出すときに必要です。

Type: BOOL

関数が成功すると、戻り値は 0 以外の値になります。

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

戻り値	説明
ERROR_ACCESS_DENIED	アクセスが拒否されました。FAX_PORT_QUERY アクセス権が必要です。
ERROR_NOT_ENOUGH_MEMORY	メモリの割り当て中にエラーが発生しました。
ERROR_INVALID_HANDLE	ポートは既に PORT_OPEN_MODIFY アクセスで開かれています。
ERROR_BAD_UNIT	DeviceId パラメーターが無効です。

ファクスポートのハンドルを取得するには、FaxOpenPort 関数を呼び出します。取得したハンドルは、次の関数を呼び出すときに使用します。

• FaxSetPort: ポートの構成を変更します
• FaxEnumRoutingMethods: デバイスに関連付けられたファクスルーティング方法に関する情報を取得します

FaxEnumPorts 関数は、FAX_PORT_INFO 構造体の配列を返します。各構造体には、1 つのポートに関する詳細情報が格納され、DeviceId パラメーターに渡す有効な値も含まれます。このデバイス識別子はファクスサーバーへの関数呼び出しの間で変化する可能性があるため、アプリケーションは永続的な形で保存しないでください。

詳細については、Fax Ports、Fax Device Management、および Managing Fax Routing Data を参照してください。