DsGetSiteNameA-Funktion (dsgetdc.h)

  • Artikel

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

Weitere Informationen

Verzeichnisdienstfunktionen

Dsgetdcname

DsValidateSubnetName

NetApiBufferFree