DsRoleGetPrimaryDomainInformation-Funktion (dsrole.h)

Die DsRoleGetPrimaryDomainInformation-Funktion ruft Zustandsdaten für den Computer ab. Diese Daten umfassen den Status der Verzeichnisdienstinstallation und Domänendaten.

Syntax

DWORD DsRoleGetPrimaryDomainInformation(
  [in]  LPCWSTR                          lpServer,
  [in]  DSROLE_PRIMARY_DOMAIN_INFO_LEVEL InfoLevel,
  [out] PBYTE                            *Buffer
);

Parameter

[in] lpServer

Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den Namen des Computers enthält, auf dem die Funktion aufgerufen werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] InfoLevel

Enthält einen der DSROLE_PRIMARY_DOMAIN_INFO_LEVEL-Werte , die den Typ der abzurufenden Daten angeben. Dieser Parameter bestimmt auch das Format der in Buffer bereitgestellten Daten.

[out] Buffer

Zeiger auf die Adresse eines Puffers, der die angeforderten Daten empfängt. Das Format dieser Daten hängt vom Wert des InfoLevel-Parameters ab.

Der Aufrufer muss diesen Arbeitsspeicher freigeben, wenn er nicht mehr benötigt wird, indem DsRoleFreeMemory aufgerufen wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	dsrole.h
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

DSROLE_OPERATION_STATE_INFO

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

DSROLE_UPGRADE_STATUS_INFO

Verzeichnisdienstfunktionen

DsRoleFreeMemory