ホーム › System.AddressBook › IProviderAdmin
IProviderAdmin
COMメソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
| hResult | HRESULT | in | 詳細なエラー情報を取得する対象の HRESULT エラーコードを指定する。 |
| ulFlags | DWORD | in | 文字列の形式 (ANSI/Unicode) を制御するフラグを指定する。 |
| lppMAPIError | MAPIERROR** | out | エラーの詳細を格納した MAPIERROR 構造体を受け取るポインタである。 |
vtbl 4 HRESULT GetProviderTable(DWORD ulFlags, IMAPITable** lppTable)
| ulFlags | DWORD | in | テーブル取得の動作を制御するフラグを指定する。 |
| lppTable | IMAPITable** | out | プロファイルに含まれるサービスプロバイダーの一覧を示すテーブル IMAPITable を受け取るポインタである。 |
vtbl 5 HRESULT CreateProvider(CHAR* lpszProvider, DWORD cValues, SPropValue* lpProps, UINT_PTR ulUIParam, DWORD ulFlags, MAPIUID* lpUID)
| lpszProvider | CHAR* | in | 作成するプロバイダーの名前文字列を指定する。 |
| cValues | DWORD | in | lpProps 配列に含まれるプロパティ値の個数を指定する。 |
| lpProps | SPropValue* | in | プロバイダーに設定するプロパティ値の配列 SPropValue へのポインタである。 |
| ulUIParam | UINT_PTR | inoptional | 操作時の親ウィンドウのハンドルを指定する。 |
| ulFlags | DWORD | in | プロバイダー作成の動作を制御するフラグを指定する。 |
| lpUID | MAPIUID* | out | 作成されたプロバイダーセクションを識別する MAPIUID を受け取るポインタである。 |
| lpUID | MAPIUID* | in | 削除するプロバイダーを識別する MAPIUID へのポインタである。 |
vtbl 7 HRESULT OpenProfileSection(MAPIUID* lpUID, GUID* lpInterface, DWORD ulFlags, IProfSect** lppProfSect)
| lpUID | MAPIUID* | inoptional | 開くプロファイルセクションを識別する MAPIUID へのポインタである。 |
| lpInterface | GUID* | inoptional | 開くプロファイルセクションに要求するインターフェイスの識別子 (IID) へのポインタである。既定でよければ NULL を指定する。 |
| ulFlags | DWORD | in | プロファイルセクションを開く際の動作を制御するフラグを指定する。 |
| lppProfSect | IProfSect** | out | 開かれたプロファイルセクション IProfSect を受け取るポインタである。 |
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IProviderAdmin "{}" #usecom global IProviderAdmin IID_IProviderAdmin "{}" #comfunc global IProviderAdmin_GetLastError 3 int,int,var #comfunc global IProviderAdmin_GetProviderTable 4 int,sptr #comfunc global IProviderAdmin_CreateProvider 5 var,int,var,sptr,int,var #comfunc global IProviderAdmin_DeleteProvider 6 var #comfunc global IProviderAdmin_OpenProfileSection 7 var,var,int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IProviderAdmin "{}" #usecom global IProviderAdmin IID_IProviderAdmin "{}" #comfunc global IProviderAdmin_GetLastError 3 int,int,sptr #comfunc global IProviderAdmin_GetProviderTable 4 int,sptr #comfunc global IProviderAdmin_CreateProvider 5 sptr,int,sptr,sptr,int,sptr #comfunc global IProviderAdmin_DeleteProvider 6 sptr #comfunc global IProviderAdmin_OpenProfileSection 7 sptr,sptr,int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。