Win32 API 日本語リファレンス
ホーム › Devices.Fax › IFaxSender

IFaxSender

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID0d879d7d-f57a-4cc6-a6f9-3ee5d527b46a継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

IFaxSender インターフェイスは、FAX クライアントアプリケーションが FAX 送信者に関する送信者情報を取得および設定するために使用するメッセージングオブジェクトを定義します。このオブジェクトには、送信者データをローカルレジストリに保存したり、ローカルレジストリから取得したりするメソッドも含まれます。

解説(Remarks)

IFaxSender の既定の実装は、FaxSender オブジェクトとして提供されます。

メソッド 34

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_BillingCode(LPWSTR* pbstrBillingCode)

IFaxSender::get_BillingCode プロパティは、送信者に関連付けられた課金コードを格納する null 終端文字列です。(取得)

pbstrBillingCodeLPWSTR*out送信者の課金コードを受け取るBSTR出力先。
vtbl 8 HRESULT put_BillingCode(LPWSTR bstrBillingCode)

IFaxSender::get_BillingCode プロパティは、送信者に関連付けられた課金コードを格納する null 終端文字列です。(設定)

bstrBillingCodeLPWSTRin設定する課金コード。
vtbl 9 HRESULT get_City(LPWSTR* pbstrCity)
pbstrCityLPWSTR*out送信者の市区町村を受け取るBSTR出力先。
vtbl 10 HRESULT put_City(LPWSTR bstrCity)
bstrCityLPWSTRin設定する市区町村。
vtbl 11 HRESULT get_Company(LPWSTR* pbstrCompany)

IFaxSender::get_Company プロパティは、送信者に関連付けられた会社名を格納する null 終端文字列です。(取得)

pbstrCompanyLPWSTR*out送信者の会社名を受け取るBSTR出力先。
vtbl 12 HRESULT put_Company(LPWSTR bstrCompany)

IFaxSender::get_Company プロパティは、送信者に関連付けられた会社名を格納する null 終端文字列です。(設定)

bstrCompanyLPWSTRin設定する会社名。
vtbl 13 HRESULT get_Country(LPWSTR* pbstrCountry)
pbstrCountryLPWSTR*out送信者の国名を受け取るBSTR出力先。
vtbl 14 HRESULT put_Country(LPWSTR bstrCountry)
bstrCountryLPWSTRin設定する国名。
vtbl 15 HRESULT get_Department(LPWSTR* pbstrDepartment)

IFaxSender::get_Department プロパティは、送信者に関連付けられた部署名を格納する null 終端文字列です。(取得)

pbstrDepartmentLPWSTR*out送信者の部署名を受け取るBSTR出力先。
vtbl 16 HRESULT put_Department(LPWSTR bstrDepartment)

IFaxSender::get_Department プロパティは、送信者に関連付けられた部署名を格納する null 終端文字列です。(設定)

bstrDepartmentLPWSTRin設定する部署名。
vtbl 17 HRESULT get_Email(LPWSTR* pbstrEmail)

IFaxSender::get_Email プロパティは、送信者に関連付けられたメールアドレスを格納する null 終端文字列です。(取得)

pbstrEmailLPWSTR*out送信者のメールアドレスを受け取るBSTR出力先。
vtbl 18 HRESULT put_Email(LPWSTR bstrEmail)

IFaxSender::get_Email プロパティは、送信者に関連付けられたメールアドレスを格納する null 終端文字列です。(設定)

bstrEmailLPWSTRin設定するメールアドレス。
vtbl 19 HRESULT get_FaxNumber(LPWSTR* pbstrFaxNumber)

IFaxSender::get_FaxNumber プロパティは、送信者に関連付けられた FAX 番号を格納する null 終端文字列です。(取得)

pbstrFaxNumberLPWSTR*out送信者のFAX番号を受け取るBSTR出力先。
vtbl 20 HRESULT put_FaxNumber(LPWSTR bstrFaxNumber)

IFaxSender::get_FaxNumber プロパティは、送信者に関連付けられた FAX 番号を格納する null 終端文字列です。(設定)

bstrFaxNumberLPWSTRin設定する送信者のFAX番号。
vtbl 21 HRESULT get_HomePhone(LPWSTR* pbstrHomePhone)

IFaxSender::get_HomePhone プロパティは、送信者に関連付けられた自宅の電話番号を格納する null 終端文字列です。(取得)

pbstrHomePhoneLPWSTR*out送信者の自宅電話番号を受け取るBSTR出力先。
vtbl 22 HRESULT put_HomePhone(LPWSTR bstrHomePhone)

IFaxSender::get_HomePhone プロパティは、送信者に関連付けられた自宅の電話番号を格納する null 終端文字列です。(設定)

bstrHomePhoneLPWSTRin設定する自宅電話番号。
vtbl 23 HRESULT get_Name(LPWSTR* pbstrName)

IFaxSender::get_Name プロパティは、送信者の名前を格納する null 終端文字列です。(取得)

pbstrNameLPWSTR*out送信者の氏名を受け取るBSTR出力先。
vtbl 24 HRESULT put_Name(LPWSTR bstrName)

IFaxSender::get_Name プロパティは、送信者の名前を格納する null 終端文字列です。(設定)

bstrNameLPWSTRin設定する送信者の氏名。
vtbl 25 HRESULT get_TSID(LPWSTR* pbstrTSID)

IFaxSender::get_TSID プロパティは、送信者のデバイスの送信局識別子 (TSID) を格納する null 終端文字列です。(取得)

pbstrTSIDLPWSTR*out送信局識別子(TSID)を受け取るBSTR出力先。
vtbl 26 HRESULT put_TSID(LPWSTR bstrTSID)

IFaxSender::get_TSID プロパティは、送信者のデバイスの送信局識別子 (TSID) を格納する null 終端文字列です。(設定)

bstrTSIDLPWSTRin設定する送信局識別子(TSID)。
vtbl 27 HRESULT get_OfficePhone(LPWSTR* pbstrOfficePhone)

IFaxSender::get_OfficePhone プロパティは、送信者に関連付けられた勤務先の電話番号を格納する null 終端文字列です。(取得)

pbstrOfficePhoneLPWSTR*out送信者の勤務先電話番号を受け取るBSTR出力先。
vtbl 28 HRESULT put_OfficePhone(LPWSTR bstrOfficePhone)

IFaxSender::get_OfficePhone プロパティは、送信者に関連付けられた勤務先の電話番号を格納する null 終端文字列です。(設定)

bstrOfficePhoneLPWSTRin設定する勤務先電話番号。
vtbl 29 HRESULT get_OfficeLocation(LPWSTR* pbstrOfficeLocation)

IFaxSender::get_OfficeLocation プロパティは、送信者の勤務地を格納する null 終端文字列です。(取得)

pbstrOfficeLocationLPWSTR*out送信者の勤務地を受け取るBSTR出力先。
vtbl 30 HRESULT put_OfficeLocation(LPWSTR bstrOfficeLocation)

IFaxSender::get_OfficeLocation プロパティは、送信者の勤務地を格納する null 終端文字列です。(設定)

bstrOfficeLocationLPWSTRin設定する勤務地。
vtbl 31 HRESULT get_State(LPWSTR* pbstrState)
pbstrStateLPWSTR*out送信者の都道府県/州を受け取るBSTR出力先。
vtbl 32 HRESULT put_State(LPWSTR bstrState)
bstrStateLPWSTRin設定する都道府県/州。
vtbl 33 HRESULT get_StreetAddress(LPWSTR* pbstrStreetAddress)

IFaxSender::get_StreetAddress プロパティは、送信者に関連付けられた住所を格納する null 終端文字列です。(取得)

pbstrStreetAddressLPWSTR*out送信者の番地を含む住所を受け取るBSTR出力先。

解説(Remarks)

住所には、送信者の市区町村、都道府県 (州)、郵便番号、および国/地域も含める必要があります。

vtbl 34 HRESULT put_StreetAddress(LPWSTR bstrStreetAddress)

IFaxSender::get_StreetAddress プロパティは、送信者に関連付けられた住所を格納する null 終端文字列です。(設定)

bstrStreetAddressLPWSTRin設定する番地を含む住所。

解説(Remarks)

住所には、送信者の市区町村、都道府県 (州)、郵便番号、および国/地域も含める必要があります。

vtbl 35 HRESULT get_Title(LPWSTR* pbstrTitle)

IFaxSender::get_Title プロパティは、送信者に関連付けられた肩書きを格納する null 終端文字列です。(取得)

pbstrTitleLPWSTR*out送信者の役職を受け取るBSTR出力先。
vtbl 36 HRESULT put_Title(LPWSTR bstrTitle)

IFaxSender::get_Title プロパティは、送信者に関連付けられた肩書きを格納する null 終端文字列です。(設定)

bstrTitleLPWSTRin設定する役職。
vtbl 37 HRESULT get_ZipCode(LPWSTR* pbstrZipCode)
pbstrZipCodeLPWSTR*out送信者の郵便番号を受け取るBSTR出力先。
vtbl 38 HRESULT put_ZipCode(LPWSTR bstrZipCode)
bstrZipCodeLPWSTRin設定する郵便番号。
vtbl 39 HRESULT LoadDefaultSender()

IFaxSender::get_LoadDefaultSender メソッドは、既定の送信者情報を FaxSender オブジェクトに設定します。

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

既定の送信者情報は、IFaxSender::SaveDefaultSender メソッドを使用して保存されます。

このメソッドは、リモートプロシージャコール (RPC) の戻り値を返すことがあります。詳細については、RPC Return Values を参照してください。

vtbl 40 HRESULT SaveDefaultSender()

IFaxSender::SaveDefaultSender メソッドは、FaxSender オブジェクトが保持する既定の送信者に関する情報を保存します。

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

既定の送信者情報を FaxSender オブジェクトに読み込むには、IFaxSender::get_LoadDefaultSender メソッドを使用します。

このメソッドは、リモートプロシージャコール (RPC) の戻り値を返すことがあります。詳細については、RPC Return Values を参照してください。

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

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IFaxSender "{0D879D7D-F57A-4CC6-A6F9-3EE5D527B46A}"
#usecom global IFaxSender IID_IFaxSender "{}"
#comfunc global IFaxSender_get_BillingCode     7 var
#comfunc global IFaxSender_put_BillingCode     8 wstr
#comfunc global IFaxSender_get_City            9 var
#comfunc global IFaxSender_put_City            10 wstr
#comfunc global IFaxSender_get_Company         11 var
#comfunc global IFaxSender_put_Company         12 wstr
#comfunc global IFaxSender_get_Country         13 var
#comfunc global IFaxSender_put_Country         14 wstr
#comfunc global IFaxSender_get_Department      15 var
#comfunc global IFaxSender_put_Department      16 wstr
#comfunc global IFaxSender_get_Email           17 var
#comfunc global IFaxSender_put_Email           18 wstr
#comfunc global IFaxSender_get_FaxNumber       19 var
#comfunc global IFaxSender_put_FaxNumber       20 wstr
#comfunc global IFaxSender_get_HomePhone       21 var
#comfunc global IFaxSender_put_HomePhone       22 wstr
#comfunc global IFaxSender_get_Name            23 var
#comfunc global IFaxSender_put_Name            24 wstr
#comfunc global IFaxSender_get_TSID            25 var
#comfunc global IFaxSender_put_TSID            26 wstr
#comfunc global IFaxSender_get_OfficePhone     27 var
#comfunc global IFaxSender_put_OfficePhone     28 wstr
#comfunc global IFaxSender_get_OfficeLocation  29 var
#comfunc global IFaxSender_put_OfficeLocation  30 wstr
#comfunc global IFaxSender_get_State           31 var
#comfunc global IFaxSender_put_State           32 wstr
#comfunc global IFaxSender_get_StreetAddress   33 var
#comfunc global IFaxSender_put_StreetAddress   34 wstr
#comfunc global IFaxSender_get_Title           35 var
#comfunc global IFaxSender_put_Title           36 wstr
#comfunc global IFaxSender_get_ZipCode         37 var
#comfunc global IFaxSender_put_ZipCode         38 wstr
#comfunc global IFaxSender_LoadDefaultSender   39
#comfunc global IFaxSender_SaveDefaultSender   40
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。