Methoden der IADsADSystemInfo-Eigenschaft

Die Eigenschaftenmethoden der IADsADSystemInfo-Schnittstelle rufen die in der folgenden Tabelle beschriebenen Eigenschaften ab oder legen sie fest. Weitere Informationen finden Sie unter Schnittstelleneigenschaftenmethoden.

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 einheitlichen 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 das Schema master Rolle 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 distinguished Active Directory-Namen des aktuellen Benutzers ab, d. h. der angemeldete Benutzer oder der Benutzer, der vom aufrufenden Thread identitätswechselt wird.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

Beispiele

Im folgenden C++-Codebeispiel werden die Windows-Systeminformationen abgerufen. Aus Gründen der Kürze wird die Fehlerüberprüfung ausgelassen.

#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-Systeminformationen 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)	WindowsServer 2008
Header	Iads.h
DLL	Activeds.dll
IID	IID_IADsADSystemInfo ist definiert als 5BB11929-AFD1-11D2-9CB9-0000F87A369E

Siehe auch

IADsADSystemInfo

Cocreateinstance