IFaxServer デュアル インターフェイスは、FAX サービスへの接続を管理するために FAX クライアント アプリケーションによって使用されます。 インターフェイスは FaxServer オブジェクトに関する情報を取得および設定します。たとえば、再送信、ブランド化、アーカイブ、表紙の設定などです。割引率期間。と FAX サーバー キューの状態。 IFaxServer インターフェイスには、次のメソッドが含まれています。
- FAX サーバーとの接続を開始および終了するメソッド。
- FaxServer オブジェクトの個々のプロパティ値を取得および設定するプロパティ メソッド。
- FaxJobs、FaxPorts、および FaxDoc オブジェクトを作成するメソッド。
メモFAX クライアント アプリケーションは、IFax で始まるほとんどのインターフェイスにアクセスする前に、IFaxServer::Connect メソッドを呼び出してアクティブな FAX サーバーとの接続を開始する必要があります。 ( IFaxTiff インターフェイスにアクセスするために FAX サーバー接続は必要ありません)。
継承
IFaxServer インターフェイスは、IDispatch インターフェイスから継承されます。 IFaxServer には、次の種類のメンバーもあります。
メソッド
IFaxServer インターフェイスには、次のメソッドがあります。
|
IFaxServer::Connect Connect メソッドは、指定された FAX サーバーに FAX クライアント アプリケーションを接続します。 |
|
IFaxServer::CreateDocument IFaxServer::CreateDocument メソッドは、指定された FaxServer オブジェクトの FaxDoc オブジェクトを作成します。 FaxDoc オブジェクトを使用すると、ユーザーはドキュメントを作成し、1 人以上の FAX 受信者に送信できます。 |
|
IFaxServer::D isconnect IFaxServer::D isconnect メソッドは、FAX クライアント アプリケーションの FAX サーバーへの接続を終了します。 |
|
IFaxServer::get_ArchiveDirectory IFaxServer::get_ArchiveDirectory メソッドは、FaxServer オブジェクトの ArchiveDirectory プロパティを取得します。 ArchiveDirectory プロパティは、アーカイブされた送信 FAX を FAX サーバーが格納する場所を含む null で終わる文字列です。 (Get) |
|
IFaxServer::get_ArchiveOutboundFaxes FaxServer オブジェクトの ArchiveOutboundFaxes プロパティを設定または取得します。 ArchiveOutboundFaxes プロパティは、FAX サーバーが送信 FAX 送信をアーカイブするかどうかを示すブール値です。 (Get) |
|
IFaxServer::get_Branding FaxServer オブジェクトの Branding プロパティを設定または取得します。 Branding プロパティは、FAX サーバーが FAX 送信の先頭にブランド化情報を生成するかどうかを示すブール値です。 (Get) |
|
IFaxServer::get_DirtyDays FaxServer オブジェクトの DirtyDays プロパティを設定または取得します。 DirtyDays プロパティは、FAX サーバーが未送信のジョブを FAX ジョブ キューに保持する日数です。 (Get) |
|
IFaxServer::get_DiscountRateEndHour FaxServer オブジェクトの DiscountRateEndHour プロパティを設定または取得します。 DiscountRateEndHour プロパティは、割引期間が終了する時間を表す数値です。 割引期間は、送信 FAX 送信にのみ適用されます。 (Get) |
|
IFaxServer::get_DiscountRateEndMinute FaxServer オブジェクトの DiscountRateEndMinute プロパティを設定または取得します。 DiscountRateEndMinute プロパティは、割引期間が終了する分を表す数値です。 割引期間は、送信 FAX 送信にのみ適用されます。 (Get) |
|
IFaxServer::get_DiscountRateStartHour FaxServer オブジェクトの DiscountRateStartHour プロパティを設定または取得します。 DiscountRateStartHour プロパティは、割引期間の開始時間を表す数値です。 割引期間は、送信 FAX 送信にのみ適用されます。 (Get) |
|
IFaxServer::get_DiscountRateStartMinute FaxServer オブジェクトの DiscountRateStartMinute プロパティを設定または取得します。 DiscountRateStartMinute プロパティは、割引期間が開始される分を表す数値です。 割引期間は、送信 FAX 送信にのみ適用されます。 (Get) |
|
IFaxServer::get_PauseServerQueue FaxServer オブジェクトの PauseServerQueue プロパティを設定または取得します。 PauseServerQueue プロパティは、FAX サーバーが FAX ジョブ キューを一時停止したかどうかを示すブール値です。 (Get) |
|
IFaxServer::get_Retries FaxServer オブジェクトの Retries プロパティを設定または取得します。 Retries プロパティは、最初の送信に失敗したときに FAX サーバーが送信 FAX の再送信を試行する回数を表す値です。 (Get) |
|
IFaxServer::get_RetryDelay FaxServer オブジェクトの RetryDelay プロパティを設定または取得します。 RetryDelay プロパティは、送信 FAX ジョブの再送信を試みる前に FAX サーバーが待機する時間間隔 (分単位) を表す値です。 (Get) |
|
IFaxServer::get_ServerCoverpage FaxServer オブジェクトの ServerCoverpage プロパティを設定または取得します。 ServerCoverpage プロパティは、FAX サーバーが一般的な表紙の使用のみを許可するかどうかを示すブール値です。 (Get) |
|
IFaxServer::get_ServerMapiProfile FaxServer オブジェクトの ServerMapiProfile プロパティを設定または取得します。 ServerMapiProfile プロパティは、受信 FAX 送信のルーティングに FAX サーバーが使用する MAPI ユーザー プロファイルを含む null で終わる文字列です。 (Get) |
|
IFaxServer::get_UseDeviceTsid FaxServer オブジェクトの UseDeviceTsid プロパティを設定または取得します。 UseDeviceTsid プロパティは、FAX サーバーがユーザー指定の TSID の代わりにデバイスの送信ステーション識別子 (TSID) を使用するかどうかを示すブール値です。 (Get) |
|
IFaxServer::GetJobs GetJobs メソッドは、指定した FaxServer オブジェクトの FaxJobs オブジェクトを作成して初期化します。 FaxJobs オブジェクトを使用すると、接続されている FAX サーバーの現在のキューに登録されているジョブを列挙できます。 |
|
IFaxServer::GetPorts GetPorts メソッドは、指定した FaxServer オブジェクトの FaxPorts オブジェクトを作成して初期化します。 FaxPorts オブジェクトを使用すると、接続されている FAX サーバーの FAX ポート構成情報を列挙できます。 |
|
IFaxServer::p ut_ArchiveDirectory IFaxServer::get_ArchiveDirectory メソッドは、FaxServer オブジェクトの ArchiveDirectory プロパティを取得します。 ArchiveDirectory プロパティは、アーカイブされた送信 FAX を FAX サーバーが格納する場所を含む null で終わる文字列です。 (Put) |
|
IFaxServer::p ut_ArchiveOutboundFaxes FaxServer オブジェクトの ArchiveOutboundFaxes プロパティを設定または取得します。 ArchiveOutboundFaxes プロパティは、FAX サーバーが送信 FAX 送信をアーカイブするかどうかを示すブール値です。 (Put) |
|
IFaxServer::p ut_Branding FaxServer オブジェクトの Branding プロパティを設定または取得します。 Branding プロパティはブール値であり、FAX サーバーが FAX 送信の上部でブランド化情報を生成するかどうかを示します。 (Put) |
|
IFaxServer::p ut_DirtyDays FaxServer オブジェクトの DirtyDays プロパティを設定または取得します。 DirtyDays プロパティは、FAX サーバーが未送信のジョブを FAX ジョブ キューに保持する日数です。 (Put) |
|
IFaxServer::p ut_DiscountRateEndHour FaxServer オブジェクトの DiscountRateEndHour プロパティを設定または取得します。 DiscountRateEndHour プロパティは、割引期間が終了する時間を表す数値です。 割引期間は、送信 FAX 送信にのみ適用されます。 (Put) |
|
IFaxServer::p ut_DiscountRateEndMinute FaxServer オブジェクトの DiscountRateEndMinute プロパティを設定または取得します。 DiscountRateEndMinute プロパティは、割引期間が終了する分を表す数値です。 割引期間は、送信 FAX 送信にのみ適用されます。 (Put) |
|
IFaxServer::p ut_DiscountRateStartHour FaxServer オブジェクトの DiscountRateStartHour プロパティを設定または取得します。 DiscountRateStartHour プロパティは、割引期間が開始される時間を表す数値です。 割引期間は、送信 FAX 送信にのみ適用されます。 (Put) |
|
IFaxServer::p ut_DiscountRateStartMinute FaxServer オブジェクトの DiscountRateStartMinute プロパティを設定または取得します。 DiscountRateStartMinute プロパティは、割引期間が開始される分を表す数値です。 割引期間は、送信 FAX 送信にのみ適用されます。 (Put) |
|
IFaxServer::p ut_PauseServerQueue FaxServer オブジェクトの PauseServerQueue プロパティを設定または取得します。 PauseServerQueue プロパティは、FAX サーバーが FAX ジョブ キューを一時停止したかどうかを示すブール値です。 (Put) |
|
IFaxServer::p ut_Retries FaxServer オブジェクトの Retries プロパティを設定または取得します。 Retries プロパティは、初期転送が失敗したときに FAX サーバーが送信 FAX の再送信を試みる回数を表す値です。 (Put) |
|
IFaxServer::p ut_RetryDelay FaxServer オブジェクトの RetryDelay プロパティを設定または取得します。 RetryDelay プロパティは、送信 FAX ジョブの再送信を試みる前に FAX サーバーが待機する時間間隔 (分単位) を表す値です。 (Put) |
|
IFaxServer::p ut_ServerCoverpage FaxServer オブジェクトの ServerCoverpage プロパティを設定または取得します。 ServerCoverpage プロパティは、FAX サーバーが共通の表紙の使用のみを許可するかどうかを示すブール値です。 (Put) |
|
IFaxServer::p ut_ServerMapiProfile FaxServer オブジェクトの ServerMapiProfile プロパティを設定または取得します。 ServerMapiProfile プロパティは、FAX サーバーが着信 FAX 送信のルーティングに使用する MAPI ユーザー プロファイルを含む null で終わる文字列です。 (Put) |
|
IFaxServer::p ut_UseDeviceTsid FaxServer オブジェクトの UseDeviceTsid プロパティを設定または取得します。 UseDeviceTsid プロパティは、FAX サーバーがユーザー指定の TSID ではなくデバイスの送信ステーション識別子 (TSID) を使用するかどうかを示すブール値です。 (Put) |
解説
実装するタイミング
このインターフェイスは実装しないでください。 Microsoft 標準実装では、完全な機能が提供されます。使用するタイミング
IFaxServer インターフェイスを使用して、アクティブな FAX サーバーとの接続と切断を行います。 また、 インターフェイスを使用して FaxServer オブジェクトのプロパティを取得および設定し、次の手順に示すオブジェクトを作成します。FAX サーバーに接続し、他の FAX クライアント オブジェクトを作成するには、次の手順を実行します。
- CoCreateInstance 関数を呼び出して、IFaxServer インターフェイスへのポインターを取得し、FaxServer オブジェクトのインスタンスを作成します。
- IFaxServer::Connect メソッドを呼び出して、アクティブな FAX サーバーとの接続を開始します。
- 接続を取得したら、次のメソッドを呼び出して、必要なオブジェクトを作成します。
- FAXJobs オブジェクトを作成するための IFaxServer::GetJobs メソッド。 このオブジェクトを使用して FaxJob オブジェクトを作成し、接続されている FAX サーバーに関連付けられている FAX ジョブを列挙します。
- FaxPorts オブジェクトを作成するための IFaxServer::GetPorts メソッド。 FAXPort オブジェクトを作成し、 FAX サーバーへの接続の FAX ポート構成情報を列挙するには、このオブジェクトを使用します。
- FAXDoc オブジェクトを作成するための IFaxServer::CreateDocument メソッド。 FAX を送信したり、FAXDoc オブジェクトのプロパティを取得および設定したりするには、このオブジェクトを使用します。
- FAX サーバーから切断するには、 IFaxServer::D isconnect メソッドを呼び出します。
- 各オブジェクトの IUnknown::Release メソッドを呼び出して、オブジェクト自体の割り当てを解除できるようにします。 必要に応じてメソッドを再度呼び出して、 IFaxPorts または IFaxJobs インターフェイス ポインターを破棄します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | faxcom.h |