DsGetDcSiteCoverageA-Funktion (dsgetdc.h)
Die DsGetDcSiteCoverage-Funktion gibt die Websitenamen aller Websites zurück, die von einem Domänencontroller abgedeckt werden.
Syntax
DSGETDCAPI DWORD DsGetDcSiteCoverageA(
[in, optional] LPCSTR ServerName,
[out] PULONG EntryCount,
[out] LPSTR **SiteNames
);
Parameter
[in, optional] ServerName
Der NULL-endende Zeichenfolgenwert, der den Namen des Remotedomänencontrollers angibt.
[out] EntryCount
Zeiger auf einen ULONG-Wert , der die Anzahl der vom Domänencontroller abgedeckten Standorte empfängt.
[out] SiteNames
Zeiger auf ein Array von Zeigern auf NULL-beendete Zeichenfolgen, die die Websitenamen empfängt. Um den zurückgegebenen Puffer freizugeben, rufen Sie die NetApiBufferFree-Funktion auf.
Rückgabewert
Diese Funktion gibt DSGETDCAPI DWORD zurück.
Hinweise
Hinweis
Der dsgetdc.h-Header definiert DsGetDcSiteCoverage als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | dsgetdc.h |
| Bibliothek | Netapi32.lib |
| DLL | Netapi32.dll |