IDsAdminCreateObj：：CreateModal 方法 (dsadmin.h)

發行項
02/26/2024

IDsAdminCreateObj：：CreateModal 方法會顯示物件建立精靈，並傳回新建立的物件。必須先呼叫 IDsAdminCreateObj：：Initialize 方法，才能呼叫 IDsAdminCreateObj：：CreateModal 。

語法

HRESULT CreateModal(
  [in]  HWND hwndParent,
  [out] IADs **ppADsObj
);

參數

[in] hwndParent

包含精靈擁有者的視窗句柄。這個值不可以是 NULL。如果沒有父視窗可用，請使用 GetDesktopWindow 函式的結果。

[out] ppADsObj

接收新建立物件的 IADs 介面指標指標。如果物件建立精靈失敗或取消，此參數會收到 NULL 。當不再需要此介面時，呼叫端必須釋放此介面。如果不需要這個對象，這個參數可能是 NULL 。

傳回值

這個方法可以傳回下列其中一個值。

傳回 OLE 定義的錯誤碼或下列其中一個值。

備註

如果使用者取消物件建立精靈，此方法會傳回S_FALSE。如果 ppADsObj 不是 NULL，ppADsObj 會收到 NULL 值。因此，使用 SUCCEEDED 宏來判斷 應該避免 ppADsObj 是否有效。在使用介面指標之前，請一律先測試 ppADsObj 中非 NULL 值的內容。