Compartilhar via

Método IADsADSystemInfo::GetDCSiteName (iads.h)

  • Artigo

O método IADsADSystemInfo::GetDCSiteName recupera o nome do site do Active Directory que contém o computador local.

Sintaxe

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

Parâmetros

[out] szServer

Nome do site do Active Directory.

[in] pszSiteName

Nome DNS do servidor de serviço.

Retornar valor

Esse método dá suporte aos valores de retorno HRESULT padrão. Para obter mais informações, consulte Códigos de erro ADSI.

Comentários

Um site do Active Directory é uma ou mais sub-redes TCP/IP bem conectadas que contêm controladores de domínio do Active Directory. Para obter mais informações, consulte Conceitos principais do Active Directory.

Exemplos

O exemplo de código C++ a seguir recupera o nome do site do Active Directory. Para resumir, a verificação de erros é omitida.

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

O exemplo de código do Visual Basic a seguir recupera o nome do site do controlador de domínio do Active Directory.

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

O exemplo de código VBScript/ASP a seguir recupera o nome do site do controlador de domínio do Active Directory.

<%
Dim sys

Set sys = CreateObject("ADSystemInfo")

dc = sys.GetAnyDCName

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

%>

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho iads.h
DLL Activeds.dll

Confira também

Códigos de erro ADSI

Conceitos principais do Active Directory

IADsADSystemInfo