IADsADSystemInfo, méthodes de propriété

Les méthodes de propriété de l’interface IADsADSystemInfo obtiennent ou définissent les propriétés décrites dans le tableau suivant. Pour plus d’informations, consultez Méthodes de propriété d’interface.

Propriétés

ComputerName

Récupère le nom unique de l’ordinateur local.

Type d'accès : Lecture seule

Type de données de script : BSTR

// C++ method syntax
HRESULT get_ComputerName(
  [out] BSTR* pbstrComputer
);

DomainDNSName

Récupère le nom DNS du domaine de l’ordinateur local, tel que « domainName.companyName.com ».

Type d'accès : Lecture seule

Type de données de script : BSTR

// C++ method syntax
HRESULT get_DomainDNSName(
  [out] BSTR* pbstr
);

DomainShortName

Récupère le nom court du domaine de l’ordinateur local, tel que « domainName ».

Type d'accès : Lecture seule

Type de données de script : BSTR

// C++ method syntax
HRESULT get_DomainShortName(
  [out] BSTR* pbstrDSN
);

ForestDNSName

Récupère le nom DNS de la forêt de l’ordinateur local.

Type d'accès : Lecture seule

Type de données de script : BSTR

// C++ method syntax
HRESULT get_ForestDNSName(
  [out] BSTR* pbstr
);

IsNativeMode

Détermine si le domaine de l’ordinateur local est en mode natif ou mixte.

Type d'accès : Lecture seule

Type de données de script : BOOL

// C++ method syntax
HRESULT get_IsNativeMode(
  [out] BOOL* pvBool
);

PDCRoleOwner

Récupère le nom unique de l’objet d’agent de service d’annuaire (DSA) pour le contrôleur de domaine qui possède le rôle de contrôleur de domaine principal dans le domaine de l’ordinateur local.

Type d'accès : Lecture seule

Type de données de script : BSTR

// C++ method syntax
HRESULT get_PDCRoleOwner(
  [out] BSTR* pbstr
);

SchemaRoleOwner

Récupère le nom unique de l’objet d’agent de service d’annuaire (DSA) pour le contrôleur de domaine qui possède le rôle de schéma master dans la forêt de l’ordinateur local.

Type d'accès : Lecture seule

Type de données de script : BSTR

// C++ method syntax
HRESULT get_SchemaRoleOwner(
  [out] BSTR* pbstr
);

SiteName

Récupère le nom du site de l’ordinateur local.

Type d'accès : Lecture seule

Type de données de script : BSTR

// C++ method syntax
HRESULT get_SiteName(
  [out] BSTR* pbstrSite
);

UserName

Récupère le nom unique Active Directory de l’utilisateur actuel, qui est l’utilisateur connecté ou l’utilisateur emprunté par le thread appelant.

Type d'accès : Lecture seule

Type de données de script : BSTR

// C++ method syntax
HRESULT get_UserName(
  [out] BSTR* pbstrUser
);

Exemples

L’exemple de code C++ suivant récupère les informations système Windows. 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 bstr;
   hr = pSys->get_UserName(&bstr);
   if (SUCCEEDED(hr)) {
      printf("User: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   hr = pSys->get_ComputerName(&bstr);
   if (SUCCEEDED(hr)) {
      printf("Computer: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   hr = pSys->get_DomainDNSName(&bstr);
   if (SUCCEEDED(hr)) {
      printf("Domain: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   hr = pSys->get_PDCRoleOwner(&bstr);
   if (SUCCEEDED(hr)) {
      printf("PDC Role owner: %S\n", bstr);
      SysFreeString(bstr);
   }
 
   if(pSys) {
      pSys->Release();
   }
 
   CoUninitialize();
   return 0;
}

L’exemple de code Visual Basic suivant récupère les informations système Windows.

Dim sys As New ADSystemInfo
Debug.print "User: " & sys.UserName
Debug.print "Computer: " & sys.ComputerName
Debug.print "Domain: " & sys.DomainDNSName
Debug.print "PDC Role Owner: " & sys.PDCRoleOwner

L’exemple de code VBScript/ASP suivant récupère les informations système Windows.

<%
Dim sys
Set sys = CreateObject("ADSystemInfo")
Response.Write "User: " & sys.UserName
Response.Write "Computer: " & sys.ComputerName
Response.Write "Domain: " & sys.DomainDNSName
Response.Write "PDC Role Owner: " & sys.PDCRoleOwner
%>

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Iads.h
DLL	Activeds.dll
IID	IID_IADsADSystemInfo est défini comme 5BB11929-AFD1-11D2-9CB9-0000F87A369E

Voir aussi

IADsADSystemInfo

CoCreateInstance