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

Weitere Informationen

Verzeichnisdienstfunktionen

DsGetSiteName

NetApiBufferFree