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 Wert der mit Null beendeten Zeichenfolge, der den Namen des Remotedomänencontrollers angibt.
[out] EntryCount
Zeiger auf einen ULONG--Wert, der die Anzahl der vom Domänencontroller abgedeckten Websites empfängt.
[out] SiteNames
Zeigen Sie auf ein Array von Zeigern auf mit Null beendete Zeichenfolgen, die die Websitenamen empfangen. Rufen Sie zum Freigeben des zurückgegebenen Puffers die NetApiBufferFree--Funktion auf.
Rückgabewert
Diese Funktion gibt DSGETDCAPI DWORD zurück.
Bemerkungen
Anmerkung
Der dsgetdc.h-Header definiert DsGetDcSiteCoverage als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | dsgetdc.h |
| Library | Netapi32.lib |
| DLL- | Netapi32.dll |