MÉTHODE IADsADSystemInfo ::GetDCSiteName (iads.h)

La méthode IADsADSystemInfo ::GetDCSiteName récupère le nom du site Active Directory qui contient l’ordinateur local.

Syntaxe

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

Paramètres

[out] szServer

Nom du site Active Directory.

[in] pszSiteName

Nom DNS du serveur de service.

Valeur retournée

Cette méthode prend en charge les valeurs de retour HRESULT standard. Pour plus d’informations, consultez Codes d’erreur ADSI.

Remarques

Un site Active Directory est un ou plusieurs sous-réseaux TCP/IP bien connectés contenant des contrôleurs de domaine Active Directory. Pour plus d’informations, consultez Concepts principaux d’Active Directory.

Exemples

L’exemple de code C++ suivant récupère le nom du site Active Directory. Par souci de concision, la vérification des erreurs est omise.

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

L’exemple de code Visual Basic suivant récupère le nom du site du contrôleur de domaine Active Directory.

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

L’exemple de code VBScript/ASP suivant récupère le nom du site du contrôleur de domaine Active Directory.

<%
Dim sys

Set sys = CreateObject("ADSystemInfo")

dc = sys.GetAnyDCName

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

%>

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	iads.h
DLL	Activeds.dll

Voir aussi

Codes d’erreur ADSI

Concepts principaux d’Active Directory

IADsADSystemInfo