IADsComputer, méthodes de propriété

Les méthodes d’interface IADsComputer lisent et écrivent les propriétés décrites dans cette rubrique. Pour plus d’informations, consultez Méthodes de propriété d’interface.

Propriétés

ComputerID

Identificateur global unique attribué à chaque ordinateur.

Type d'accès : Lecture seule

Type de données de script : BSTR

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

Département

Unité d’organisation (UO), telle que le service, à laquelle cet ordinateur appartient.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Description

Description de cet ordinateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Division

Division, au sein d’une organization, à laquelle cet ordinateur appartient.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Lieu

Emplacement physique attribué de cet ordinateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Taille de mémoire

Taille, en mégaoctets, de la mémoire d’accès aléatoire pour cet ordinateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Modèle

La fabrique et le modèle de cet ordinateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

NetAddresses

Tableau de champs NetAddress qui représentent les adresses par lesquelles cet ordinateur peut être atteint. NetAddress est un BSTR propre au fournisseur composé de deux sous-chaînes séparées par deux-points (:). La sous-chaîne de gauche indique le type d’adresse, et la sous-chaîne de droite est une représentation sous forme de chaîne d’une adresse de ce type. Par exemple, les adresses TCP/IP sont de la forme : IP:100.201.301.45. Les adresses de type IPX sont de la forme : IPX:10.123456.80.

Type d'accès : lecture/écriture

Type de données de script : VARIANT

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

OperatingSystem

Système d’exploitation utilisé sur cet ordinateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

OperatingSystemVersion

Version du système d’exploitation utilisé sur cet ordinateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Propriétaire

Personne à qui cet ordinateur est affecté. Cette personne doit également disposer d’une licence pour exécuter le logiciel installé.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

PrimaryUser

Nom de la personne de contact, par exemple un administrateur, pour cet ordinateur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Processeur

Type de processeur.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

ProcessorCount

Nombre de processeurs installés.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Rôle

Rôle de cet ordinateur, par exemple, station de travail, serveur ou contrôleur de domaine.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Site

Identificateur global unique qui identifie le site sur lequel cet ordinateur a été installé. Un site est une région physique de bonne connectivité dans un réseau.

Type d'accès : Lecture seule

Type de données de script : BSTR

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

StorageCapacité

Taille, en mégaoctets, du disque.

Type d'accès : lecture/écriture

Type de données de script : BSTR

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

Notes

Différents fournisseurs peuvent choisir d’exposer différentes propriétés d’un objet d’ordinateur. Pour plus d’informations, consultez Fournisseurs de système ADSI.

Vous pouvez découvrir les propriétés prises en charge en inspectant les propriétés obligatoires et facultatives via sa classe de schéma. Pour plus d’informations, consultez l’interface IADsClass .

Pour examiner les status d’un ordinateur ou pour effectuer l’opération d’arrêt sur le réseau, vous devez utiliser l’interface IADsComputerOperations.

Exemples

L’exemple de code Visual Basic suivant examine les propriétés de l’ordinateur prises en charge par le fournisseur 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

L’exemple de code C++ suivant examine les propriétés de l’ordinateur prises en charge par le fournisseur 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;

Spécifications

Voir aussi

IADsComputer

Fournisseurs de système ADSI

IADsClass

IADsComputerOperations

Méthodes de propriété d’interface