IDsAdminCreateObj::CreateModal-Methode (dsadmin.h)

Die IDsAdminCreateObj::CreateModal-Methode zeigt den Objekterstellungs-Assistenten an und gibt das neu erstellte Objekt zurück. Die IDsAdminCreateObj::Initialize-Methode muss aufgerufen werden, bevor IDsAdminCreateObj::CreateModal aufgerufen werden kann.

Syntax

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

Parameter

[in] hwndParent

Enthält das Fensterhandle des Besitzers des Assistenten. Dieser Wert darf nicht NULL sein. Verwenden Sie das Ergebnis der GetDesktopWindow-Funktion , wenn kein übergeordnetes Fenster verfügbar ist.

[out] ppADsObj

Zeiger auf einen IADs-Schnittstellenzeiger , der das neu erstellte Objekt empfängt. Dieser Parameter empfängt NULL , wenn der Objekterstellungs-Assistent fehlschlägt oder abgebrochen wird. Der Aufrufer muss diese Schnittstelle freigeben, wenn sie nicht mehr benötigt wird. Dieser Parameter kann NULL sein, wenn dieses Objekt nicht erforderlich ist.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Gibt einen OLE-definierten Fehlercode oder einen der folgenden Werte zurück.

Hinweise

Wenn der Benutzer den Objekterstellungs-Assistenten abbricht, gibt diese Methode S_FALSE zurück. Wenn ppADsObj nicht NULL ist, erhält ppADsObj einen NULL-Wert . Aus diesem Grund sollte die Verwendung des SUCCEEDED-Makros zum Bestimmen, ob ppADsObj gültig ist, vermieden werden. Testen Sie immer den Inhalt von ppADsObj auf einen Wert ungleich NULL , bevor Sie den Schnittstellenzeiger verwenden.

Anforderungen

Weitere Informationen

GetDesktopWindow

Iads

IDsAdminCreateObj

IDsAdminCreateObj::Initialize

GELUNGEN