DsGetSiteNameA-Funktion (dsgetdc.h)
Die DsGetSiteName-Funktion gibt den Namen des Standorts zurück, auf dem sich ein Computer befindet. Bei einem Domänencontroller (DC) ist der Name des Standorts der Speicherort des konfigurierten Domänencontrollers. Für eine Mitgliedsarbeitsstation oder einen Mitgliedsserver gibt der Name den Arbeitsstationsstandort an, der in der Domäne des Computers konfiguriert ist.
Syntax
DSGETDCAPI DWORD DsGetSiteNameA(
[in] LPCSTR ComputerName,
[out] LPSTR *SiteName
);
Parameter
[in] ComputerName
Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Servers angibt, der diese Funktion senden soll. Null impliziert den lokalen Computer.
[out] SiteName
Zeiger auf eine Variable, die einen Zeiger auf eine NULL-endende Zeichenfolge empfängt, die den Standort dieses Computers angibt. Diese Zeichenfolge wird vom System zugeordnet und muss mithilfe der NetApiBufferFree-Funktion freigegeben werden.
Rückgabewert
Wenn die Funktion Kontoinformationen zurückgibt, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.
Hinweise
Die DsGetSiteName-Funktion erfordert keinen bestimmten Zugriff auf die angegebene Domäne. Die Funktion wird an den Dienst "NetLogon" auf dem Computer gesendet, der von ComputerName angegeben wird.
Hinweis
Der Dsgetdc.h-Header definiert DsGetSiteName 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
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | dsgetdc.h |
| Bibliothek | Netapi32.lib |
| DLL | Netapi32.dll |