IADsADSystemInfo::GetDCSiteName-Methode (iads.h)
Die IADsADSystemInfo::GetDCSiteName-Methode ruft den Namen des Active Directory-Standorts ab, der den lokalen Computer enthält.
Syntax
HRESULT GetDCSiteName(
[out] BSTR szServer,
[in] BSTR *pszSiteName
);
Parameter
[out] szServer
Name des Active Directory-Standorts.
[in] pszSiteName
DNS-Name des Dienstservers.
Rückgabewert
Diese Methode unterstützt die HRESULT-Standardrückgabewerte . Weitere Informationen finden Sie unter ADSI-Fehlercodes.
Hinweise
Ein Active Directory-Standort ist ein oder mehrere gut verbundene TCP/IP-Subnetze mit Active Directory-Domänencontrollern. Weitere Informationen finden Sie unter Active Directory Core-Konzepte.
Beispiele
Im folgenden C++-Codebeispiel wird der Name des Active Directory-Standorts abgerufen. Aus Gründen der Kürze wird die Fehlerüberprüfung ausgelassen.
#include <activeds.h>
#include <stdio.h>
int main()
{
HRESULT hr;
hr = CoInitialize(NULL);
IADsADSystemInfo *pSys;
hr = CoCreateInstance(CLSID_ADSystemInfo,
NULL,
CLSCTX_INPROC_SERVER,
IID_IADsADSystemInfo,
(void**)&pSys);
BSTR siteName;
BSTR dnsServer;
hr = pSys->GetAnyDCName(&dnsServer);
if (SUCCEEDED(hr)) {
printf("Domain controller: %S\n", dnsServer);
hr = pSys->GetDCSiteName(&siteName);
if (SUCCEEDED(hr)) {
printf("Domain controller site: %S\n", siteName);
SysFreeString(siteName);
}
SysFreeString(dnsServer);
}
if(pSys) {
pSys->Release();
}
CoUninitialize();
return 0;
}
Im folgenden Visual Basic-Codebeispiel wird der Name des Active Directory-Domänencontrollerstandorts abgerufen.
Dim sys As New ADSystemInfo
dc = sys.GetAnyDCName
Debug.Print "Domain Controller site: " & sys.GetDCSiteName(dc)
Im folgenden VBScript/ASP-Codebeispiel wird der Name des Active Directory-Domänencontrollerstandorts abgerufen.
<%
Dim sys
Set sys = CreateObject("ADSystemInfo")
dc = sys.GetAnyDCName
wscript.echo "Domain Controller : " & dc
wscript.echo "Domain Controller site: " & sys.GetDCSiteName(dc)
%>
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |
| DLL | Activeds.dll |