Metodo IADsADSystemInfo::GetDCSiteName (iads.h)

Articolo
08/24/2023

Il metodo IADsADSystemInfo::GetDCSiteName recupera il nome del sito di Active Directory che contiene il computer locale.

Sintassi

HRESULT GetDCSiteName(
  [out] BSTR szServer,
  [in]  BSTR *pszSiteName
);

Parametri

[out] szServer

Nome del sito di Active Directory.

[in] pszSiteName

Nome DNS del server del servizio.

Valore restituito

Questo metodo supporta i valori restituiti HRESULT standard. Per altre informazioni, vedere Codici di errore ADSI.

Commenti

Un sito di Active Directory è una o più subnet TCP/IP ben connesse che contengono controller di dominio Active Directory. Per altre informazioni, vedere Concetti di base di Active Directory.

Esempio

Nell'esempio di codice C++ seguente viene recuperato il nome del sito di Active Directory. Per brevità, il controllo degli errori viene omesso.

#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;
}

Nell'esempio di codice di Visual Basic seguente viene recuperato il nome del sito del controller di dominio Active Directory.

Dim sys As New ADSystemInfo
dc = sys.GetAnyDCName
Debug.Print "Domain Controller site: " & sys.GetDCSiteName(dc)

Nell'esempio di codice VBScript/ASP seguente viene recuperato il nome del sito del controller di dominio Active Directory.

<%
Dim sys

Set sys = CreateObject("ADSystemInfo")

dc = sys.GetAnyDCName

wscript.echo "Domain Controller     : " & dc
wscript.echo "Domain Controller site: " & sys.GetDCSiteName(dc)

%>

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	iads.h
DLL	Activeds.dll

Vedi anche

Codici di errore ADSI

Concetti di base di Active Directory

IADsADSystemInfo

Condividi tramite