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 |