DsGetSiteNameA-Funktion (dsgetdc.h)
Die funktion DsGetSiteName gibt den Namen der Website zurück, auf der sich ein Computer befindet. Bei einem Domänencontroller (DC) ist der Name des Standorts der Speicherort des konfigurierten DC. 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
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen des Servers angibt, der diese Funktion senden soll. Ein NULL- impliziert den lokalen Computer.
[out] SiteName
Zeiger auf eine Variable, die einen Zeiger auf eine mit Null beendete Zeichenfolge empfängt, die den Standort dieses Computers angibt. Diese Zeichenfolge wird vom System zugewiesen und muss mithilfe der funktion NetApiBufferFree 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.
Bemerkungen
Die DsGetSiteName--Funktion erfordert keinen bestimmten Zugriff auf die angegebene Domäne. Die Funktion wird an den "NetLogon"-Dienst auf dem Computer gesendet, der von ComputerNameangegeben wird.
Anmerkung
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
| 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 |