Metodi di proprietà IADsComputer

I metodi di interfaccia IADsComputer leggono e scrivono le proprietà descritte in questo argomento. Per altre informazioni, vedere Metodi di proprietà dell'interfaccia.

Proprietà

ComputerID

Identificatore univoco globale assegnato a ogni computer.

Tipo di accesso: sola lettura

Tipo di dati di scripting: BSTR

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

Reparto

Unità organizzativa ,ad esempio reparto, a cui appartiene questo computer.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Descrizione

Descrizione di questo computer.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Divisione

Divisione, all'interno di un'organizzazione, a cui appartiene questo computer.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Posizione

Posizione fisica assegnata di questo computer.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

MemorySize

Dimensioni, in megabyte, di memoria di accesso casuale per questo computer.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Modello

Il modello e il make di questo computer.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

NetAddresses

Matrice di campi NetAddress che rappresentano gli indirizzi in base al quale è possibile raggiungere questo computer. NetAddress è una BSTR specifica del provider costituita da due sottostringa separate da due punti (:). La sottostringa sinistra indica il tipo di indirizzo e la sottostringa destra è una rappresentazione stringa di un indirizzo di tale tipo. Ad esempio, gli indirizzi TCP/IP sono del modulo: IP:100.201.301.45. Gli indirizzi di tipo IPX sono del modulo: IPX:10.123456.80.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: VARIANT

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

OperatingSystem

Il sistema operativo usato in questo computer.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

OperatingSystemVersion

Versione del sistema operativo usato in questo computer.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Proprietario

Persona a cui viene assegnato questo computer. Questa persona deve avere anche una licenza per eseguire il software installato.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

PrimaryUser

Nome della persona di contatto, ad esempio un amministratore, per questo computer.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Processore

Tipo di processore.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

ProcessorCount

Numero di processori installati.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Ruolo

Ruolo di questo computer, ad esempio workstation, server o controller di dominio.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Sito

Identificatore univoco globale che identifica il sito in cui è stato installato il computer. Un sito è un'area fisica di connettività ottimale in una rete.

Tipo di accesso: sola lettura

Tipo di dati di scripting: BSTR

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

StorageCapacity

Dimensioni, in megabyte, del disco.

Tipo di accesso: Lettura/scrittura

Tipo di dati di scripting: BSTR

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

Commenti

I diversi provider possono scegliere di esporre proprietà diverse di un oggetto computer. Per altre informazioni, vedere Provider di sistema ADSI.

È possibile individuare le proprietà supportate controllando le proprietà obbligatorie e facoltative tramite la relativa classe schema. Per altre informazioni, vedere l'interfaccia IADsClass .

Per esaminare lo stato di un computer o per eseguire l'operazione di arresto in rete, è necessario usare l'interfaccia IADsComputerOperations .

Esempio

Nell'esempio di codice Visual Basic seguente vengono esaminate le proprietà del computer supportate dal provider AdSI WinNT.

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

Nell'esempio di codice C++ seguente vengono esaminate le proprietà del computer supportate dal provider ADSI WinNT.

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;

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	Iads.h
DLL	Activeds.dll
IID	IID_IADsComputer è definito come EFE3CC70-1D9F-11CF-B1F3-02608C9E7553

Vedi anche

IADsComputer

Provider di sistema ADSI

IADsClass

IADsComputerOperations

Metodi di proprietà Interface