IGPM::GetDomain-Methode (gpmgmt.h)

Erstellt und gibt ein GPMDomain-Objekt zurück, das der angegebenen Domäne entspricht.

Mit dem -Objekt können Sie die folgenden Aktionen ausführen:

• Erstellen, Abfragen und Wiederherstellen Gruppenrichtlinie-Objekte (GPOs)
• Suchbereich von Verwaltungsobjekten (SOM)
• Suchen und Abrufen von WMI-Filtern (Windows Management Instrumentation)

Syntax

HRESULT GetDomain(
  [in]  BSTR       bstrDomain,
  [in]  BSTR       bstrDomainController,
  [in]  long       lDCFlags,
  [out] IGPMDomain **pIGPMDomain
);

Parameter

[in] bstrDomain

Der Name der als Zeichenfolge angegebenen Domäne. Dies muss ein vollständiger DNS-Name (Domain Name System) sein, z contoso.com. B. .

[in] bstrDomainController

Wenn angegeben, der Name des Domänencontrollers, der mit der Domäne verwendet werden soll. Der Name kann ein DNS-Name oder ein NetBIOS-Name sein. Andernfalls verwendet die -Methode den primären Domänencontroller (PDC). Weitere Informationen finden Sie im lDCFlags-Parameter .

Scripting: Dieser Parameter muss eine leere Zeichenfolge ("") übergeben, wenn kein Domänencontroller angegeben ist.

[in] lDCFlags

Flags, die verwendet werden sollen, um den Domänencontroller für die Domäne zu suchen. Sie können GPM_USE_ANYDC, GPM_USE_PDC oder GPM_DONOTUSE_W2KDC angeben.

Wenn dieser Parameter auf null festgelegt ist und ein bstrDomainController angegeben wird, verwendet die -Methode den angegebenen bstrDomainController. Andernfalls verwendet die -Methode den PDC.

[out] pIGPMDomain

Adresse eines Zeigers auf die IGPMDomain-Schnittstelle .

Rückgabewert

C++

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt einen Fehlercode zurück, wenn ein Fehler auftritt.

JScript

Gibt einen Verweis auf ein GPMDomain-Objekt zurück.

VB

Gibt einen Verweis auf ein GPMDomain-Objekt zurück.

Hinweise

Wichtig: Beim Aufrufen dieser Funktion wird der zugrunde liegende LDAP-Datenverkehr mit Kerberos und nicht mit SSL verschlüsselt.

Mit dieser Methode können Sie keine Website-SOMs durchsuchen. Rufen Sie die IGPM::GetSitesContainer-Methode auf, um diesen Abfragetyp auszuführen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	gpmgmt.h
DLL	Gpmgmt.dll

Weitere Informationen

IGPM

IGPMDomain