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

El método IADsADSystemInfo::GetDCSiteName recupera el nombre del sitio de Active Directory que contiene el equipo local.

Sintaxis

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

Parámetros

[out] szServer

Nombre del sitio de Active Directory.

[in] pszSiteName

Nombre DNS del servidor de servicio.

Valor devuelto

Este método admite los valores devueltos HRESULT estándar. Para obtener más información, consulta Códigos de error adsi.

Comentarios

Un sitio de Active Directory es una o varias subredes TCP/IP bien conectadas que contienen controladores de dominio de Active Directory. Para obtener más información, consulte Conceptos básicos de Active Directory.

Ejemplos

El siguiente ejemplo de código de C++ recupera el nombre del sitio de Active Directory. Por motivos de brevedad, se omite la comprobación de errores.

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

En el siguiente ejemplo de código de Visual Basic se recupera el nombre del sitio del controlador de dominio de Active Directory.

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

El siguiente ejemplo de código VBScript/ASP recupera el nombre del sitio del controlador de dominio de 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	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	iads.h
Archivo DLL	Activeds.dll

Consulte también

Códigos de error adsi

Conceptos básicos de Active Directory

IADsADSystemInfo