Freigeben über

Methoden der IADsComputer-Eigenschaft

  • Artikel

Die IADsComputer-Schnittstellenmethoden lesen und schreiben die in diesem Thema beschriebenen Eigenschaften. Weitere Informationen finden Sie unter Schnittstelleneigenschaftenmethoden.

Eigenschaften

ComputerID

Der global eindeutige Bezeichner, der jedem Computer zugewiesen ist.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_ComputerID(
  [out] BSTR* pbstrComputerID
);

Abteilung

Die Organisationseinheit (OU), z. B. Abteilung, zu der dieser Computer gehört.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_Department(
  [out] BSTR* pbstrDepartment
);
HRESULT put_Department(
  [in] BSTR bstrDepartment
);

Beschreibung

Die Beschreibung dieses Computers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_Description(
  [out] BSTR* pbstrDescription
);
HRESULT put_Description(
  [in] BSTR bstrDescription
);

Division

Die Division innerhalb einer organization, zu der dieser Computer gehört.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_Division(
  [out] BSTR* pbstrDivision
);
HRESULT put_Division(
  [in] BSTR bstrDivision
);

Location

Der zugewiesene physische Standort dieses Computers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_Location(
  [out] BSTR* pbstrLocation
);
HRESULT put_Location(
  [in] BSTR bstrLocation
);

MemorySize

Die Größe des Arbeitsspeichers für den zufälligen Zugriff auf diesen Computer in Megabyte.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_MemorySize(
  [out] BSTR* pbstrMemorySize
);
HRESULT put_MemorySize(
  [in] BSTR bstrMemorySize
);

Modell

Die Herstellung und das Modell dieses Computers.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_Model(
  [out] BSTR* pbstrModel
);
HRESULT put_Model(
  [in] BSTR bstrModel
);

NetAddresses

Ein Array von NetAddress-Feldern, die die Adressen darstellen, über die dieser Computer erreicht werden kann. NetAddress ist ein anbieterspezifischer BSTR , der aus zwei Teilzeichenfolgen besteht, die durch einen Doppelpunkt (:). Die linke Teilzeichenfolge gibt den Adresstyp an, und die rechte Teilzeichenfolge ist eine Zeichenfolgendarstellung einer Adresse dieses Typs. TCP/IP-Adressen haben beispielsweise die Folgende: IP:100.201.301.45. IPX-Typadressen haben die Folgende: IPX:10.123456.80.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

// C++ method syntax
HRESULT get_NetAddresses(
  [out] VARIANT* pvNetAddresses
);
HRESULT put_NetAddresses(
  [in] VARIANT vNetAddresses
);

OperatingSystem

Das betriebssystem, das auf diesem Computer verwendet wird.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_OperatingSystem(
  [out] BSTR* pbstrOperatingSystem
);
HRESULT put_OperatingSystem(
  [in] BSTR bstrOperatingSystem
);

OperatingSystemVersion

Die Version des Betriebssystems, das auf diesem Computer verwendet wird.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_OperatingSystemVersion(
  [out] BSTR* pbstrOperatingSystemVersion
);
HRESULT put_OperatingSystemVersion(
  [in] BSTR bstrOperatingSystemVersion
);

Besitzer

Die Person, der dieser Computer zugewiesen ist. Diese Person sollte auch über eine Lizenz zum Ausführen der installierten Software verfügen.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_Owner(
  [out] BSTR* pbstrOwner
);
HRESULT put_Owner(
  [in] BSTR bstrOwner
);

PrimaryUser

Der Name der Kontaktperson, z. B. eines Administrators, für diesen Computer.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_PrimaryUser(
  [out] BSTR* pbstrPrimaryUser
);
HRESULT put_PrimaryUser(
  [in] BSTR bstrPrimaryUser
);

Prozessor

Der Prozessortyp.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_Processor(
  [out] BSTR* pbstrProcessor
);
HRESULT put_Processor(
  [in] BSTR bstrProcessor
);

ProcessorCount

Die Anzahl der installierten Prozessoren.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_ProcessorCount(
  [out] BSTR* pbstrProcessorCount
);
HRESULT put_ProcessorCount(
  [in] BSTR bstrProcessorCount
);

Rolle

Die Rolle dieses Computers, z. B. Arbeitsstation, Server oder Domänencontroller.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_Role(
  [out] BSTR* pbstrRole
);
HRESULT put_Role(
  [in] BSTR bstrRole
);

Website

Der global eindeutige Bezeichner, der den Standort identifiziert, an dem dieser Computer installiert wurde. Ein Standort ist eine physische Region mit guter Konnektivität in einem Netzwerk.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: BSTR

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

StorageCapacity

Die Größe des Datenträgers in Megabyte.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_StorageCapacity(
  [out] BSTR* pbstrStorageCapacity
);
HRESULT put_StorageCapacity(
  [in] BSTR bstrStorageCapacity
);

Bemerkungen

Verschiedene Anbieter können verschiedene Eigenschaften eines Computerobjekts verfügbar machen. Weitere Informationen finden Sie unter ADSI-Systemanbieter.

Sie können ermitteln, welche Eigenschaften unterstützt werden, indem Sie die obligatorischen und optionalen Eigenschaften über die zugehörige Schemaklasse überprüfen. Weitere Informationen finden Sie unter der IADsClass-Schnittstelle .

Um die status eines Computers zu untersuchen oder den Herunterfahren-Vorgang über das Netzwerk auszuführen, müssen Sie die IADsComputerOperations-Schnittstelle verwenden.

Beispiele

Im folgenden Visual Basic-Codebeispiel werden Computereigenschaften untersucht, die vom ADSI WinNT-Anbieter unterstützt werden.

Dim obj As IADs
On Error Resume Next

Set obj = GetObject("WinNT://myMachine,computer")
If (obj.Class = "Computer") Then
    MsgBox "Computer owner: " & obj.owner
    MsgBox "Computer division: " & obj.Division
    MsgBox "Computer operatingSystem: " & obj.OperatingSystem
    MsgBox "Computer operating System Version: " & obj.OperatingSystemVersion
    MsgBox "Computer processor: " & obj.Processor
    MsgBox "Computer processor Count: " & obj.ProcessorCount
End If

Im folgenden C++-Codebeispiel werden Computereigenschaften untersucht, die vom ADSI WinNT-Anbieter unterstützt werden.

IADsComputer *pComp = NULL;
LPWSTR adspath = L"WinNT://jeffsmith1,computer";
HRESULT hr = S_OK;
BSTR bstr = NULL;

hr = ADsGetObject(adspath,IID_IADsComputer,(void**)&pComp);
if(FAILED(hr)) {goto Cleanup;}

hr = pComp->get_Owner(&bstr);
if(FAILED(hr)) {goto Cleanup;}

printf("Computer owner: %S\n",bstr);
SysFreeString(bstr);

hr = pComp->get_OperatingSystem(&bstr);
if(FAILED(hr)) {goto Cleanup;}
printf("Operating System: %S\n",bstr);
SysFreeString(bstr);

Cleanup:
    if(pComp) pComp->Release();
    if(bstr) SysFreeString(bstr);
    return hr;

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista
Unterstützte Mindestversion (Server)
 WindowsServer 2008
Header
Iads.h
DLL
Activeds.dll
IID
 IID_IADsComputer ist definiert als EFE3CC70-1D9F-11CF-B1F3-02608C9E7553

Weitere Informationen

IADsComputer

ADSI-Systemanbieter

IADs-Klasse

IADsComputerOperations

Methoden der Interface-Eigenschaft