PFAXSETPORTW

コールバック

シグネチャ

BOOL PFAXSETPORTW(
    HANDLE FaxPortHandle,
    FAX_PORT_INFOW* PortInfo
);

パラメーター

フィールド	型	説明
FaxPortHandle	HANDLE	FaxOpenPort 関数の呼び出しによって返されたファクスポートのハンドルを指定します。
PortInfo	FAX_PORT_INFOW*	FAX_PORT_INFO 構造体へのポインターです。この構造体には、指定したファクスポートの構成を変更するためのデータが格納されます。

公式ドキュメント

ファクスクライアントアプリケーションは、対象のファクスポートの構成を変更するために FaxSetPort 関数を呼び出します。構成データには、ポートの機能、優先度、応答までの呼び出し回数、送信側および着信側の局識別子などが含まれます。

戻り値

型: BOOL

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

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

戻り値	説明
ERROR_ACCESS_DENIED	アクセスが拒否されました。FAX_PORT_SET アクセス権が必要です。
ERROR_DEVICE_IN_USE	FaxPortHandle パラメーターで指定されたポートがビジー状態です。
ERROR_INVALID_PARAMETER	FaxPortHandle パラメーターまたは PortInfo パラメーターの一方、もしくは両方が NULL です。

解説(Remarks)

アプリケーションは、FaxSetPort 関数を呼び出す前に、FaxOpenPort 関数を呼び出し、アクセスレベルとして PORT_OPEN_MODIFY を指定する必要があります。

この関数で設定できるのは、FAX_PORT_INFO 構造体の次のメンバーだけです: Flags、Rings、Priority、Tsid、Csid

ファクス管理アプリケーションは通常、ファクスサーバーに関連付けられたファクスデバイスを管理するために FaxSetPort 関数を呼び出します。デバイスを照会するには、FaxGetPort 関数を呼び出します。

FaxSetPort 関数の FaxPortHandle パラメーターに指定する有効なポートハンドルを取得するには、FaxOpenPort 関数を呼び出します。詳細については、Fax Device Management を参照してください。

メモ

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

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