Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |