IADsADSystemInfo-Eigenschaftenmethoden

Die Eigenschaftenmethoden der IADsADSystemInfo-Schnittstelle erhalten oder legen die in der folgenden Tabelle beschriebenen Eigenschaften fest. Weitere Informationen finden Sie unter Schnittstelleneigenschaftsmethoden.

Eigenschaften

ComputerName

Ruft den Distinguished Name des lokalen Computers ab.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

DomainDNSName

Ruft den DNS-Namen der Domäne des lokalen Computers ab, z. B. "domainName.companyName.com".

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

DomainShortName

Ruft den Kurznamen der Domäne des lokalen Computers ab, z. B. "domainName".

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

ForestDNSName

Ruft den DNS-Namen der Gesamtstruktur des lokalen Computers ab.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

IsNativeMode

Bestimmt, ob sich die Domäne des lokalen Computers im nativ oder gemischten Modus befindet.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BOOL

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

PDCRoleOwner

Ruft den Distinguished Name des DSA-Objekts (Directory Service Agent) für den Domänencontroller ab, der die primäre Domänencontrollerrolle in der Domäne des lokalen Computers besitzt.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

SchemaRoleOwner

Ruft den Distinguished Name des DSA-Objekts (Directory Service Agent) für den Domänencontroller ab, der die Schemamasterrolle in der Gesamtstruktur des lokalen Computers besitzt.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

Sitename

Ruft den Standortnamen des lokalen Computers ab.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

UserName

Ruft den Active Directory-Distinguished Name des aktuellen Benutzers ab. Dabei handelt es sich um den angemeldeten Benutzer oder den Benutzer, dessen Identität vom aufrufenden Thread angenommen wird.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

Beispiele

Im folgenden C++-Codebeispiel werden die Windows abgerufen. Aus Kürze wird die Fehlerüberprüfung weggelassen.

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

Im folgenden Visual Basic Codebeispiel werden die Windows abgerufen.

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

Im folgenden VBScript/ASP-Codebeispiel werden die Windows Systeminformationen abgerufen.

<%
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
%>

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Header
Iads.h
DLL
Activeds.dll
IID
IID _ IADsADSystemInfo ist als 5BB11929-AFD1-11D2-9CB9-0000F87A369E definiert.

Weitere Informationen

IADsADSystemInfo

Cocreateinstance