IDsAdminNewObjPrimarySite
COM公式ドキュメント
IDsAdminNewObjPrimarySite インターフェイスはシステムによって実装され、プライマリ オブジェクト作成拡張機能が Active Directory Domain Services に新しい一時オブジェクトを作成し、そのオブジェクトを永続メモリにコミットするために使用します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
IDsAdminNewObjPrimarySite::CreateNew メソッドを使用すると、プライマリ オブジェクト作成拡張機能が Active Directory Domain Services に一時的なディレクトリ サービス オブジェクトを作成できます。
| pszName | LPWSTR | in | 作成するオブジェクトの名前を格納した WCHAR 文字列へのポインター。 |
戻り値
メソッドが成功した場合は S_OK が返されます。メソッドが失敗した場合は、OLE で定義されたエラー コードが返されます。呼び出し元の拡張機能がプライマリ オブジェクト作成拡張機能でない場合、このメソッドは失敗します。
IDsAdminNewObjPrimarySite::Commit メソッドは、単一ページのプライマリ オブジェクト作成拡張機能の IDsAdminNewObjExt::WriteData メソッドを呼び出させ、一時オブジェクトを永続メモリに書き込みます。
戻り値
成功した場合は S_OK を、それ以外の場合は OLE で定義されたエラー コードを返します。呼び出し元の拡張機能がプライマリ オブジェクト作成拡張機能でない場合、このメソッドは失敗します。また、オブジェクト作成ウィザードに複数のページが含まれている場合も、このメソッドは失敗します。
解説(Remarks)
IDsAdminNewObjPrimarySite::Commit を呼び出す前に、IDsAdminNewObjPrimarySite::CreateNew メソッドを呼び出しておく必要があります。
オブジェクト作成ウィザードに複数のページが含まれている場合、システムは、保存されるオブジェクト データの概要を表示する「完了」ページを実装します。システムが実装するこの「完了」ページが IDsAdminNewObjPrimarySite::Commit 操作を実行します。ただし、オブジェクト作成ウィザードにページが 1 つしか含まれていない場合、そのページには、ウィザードで通常見られる 戻る、次へ、キャンセル の各ボタンではなく、OK ボタンと キャンセル ボタンが表示され、「完了」ページは提供されません。このため、単一ページのオブジェクト作成拡張機能ウィザードは Commit を呼び出す必要があります。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IDsAdminNewObjPrimarySite "{BE2B487E-F904-11D2-82B9-00C04F68928B}"
#usecom global IDsAdminNewObjPrimarySite IID_IDsAdminNewObjPrimarySite "{}"
#comfunc global IDsAdminNewObjPrimarySite_CreateNew 3 wstr
#comfunc global IDsAdminNewObjPrimarySite_Commit 4
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。