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
-
-
Type d'accès : Lecture seule
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_ComputerID( [out] BSTR* pbstrComputerID );
Identificateur global unique attribué à chaque ordinateur.
-
-
Département
-
-
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 );
Unité d’organisation (UO), telle que le service, à laquelle cet ordinateur appartient.
-
-
Description
-
-
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 );
Description de cet ordinateur.
-
-
Division
-
-
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 );
Division, au sein d’une organization, à laquelle cet ordinateur appartient.
-
-
Lieu
-
-
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 );
Emplacement physique attribué de cet ordinateur.
-
-
Taille de mémoire
-
-
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 );
Taille, en mégaoctets, de la mémoire d’accès aléatoire pour cet ordinateur.
-
-
Modèle
-
-
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 );
La fabrique et le modèle de cet ordinateur.
-
-
NetAddresses
-
-
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 );
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.
-
-
OperatingSystem
-
-
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 );
Système d’exploitation utilisé sur cet ordinateur.
-
-
OperatingSystemVersion
-
-
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 );
Version du système d’exploitation utilisé sur cet ordinateur.
-
-
Propriétaire
-
-
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 );
Personne à qui cet ordinateur est affecté. Cette personne doit également disposer d’une licence pour exécuter le logiciel installé.
-
-
PrimaryUser
-
-
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 );
Nom de la personne de contact, par exemple un administrateur, pour cet ordinateur.
-
-
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 );
Type de processeur.
-
-
ProcessorCount
-
-
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 );
Nombre de processeurs installés.
-
-
Rôle
-
-
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 );
Rôle de cet ordinateur, par exemple, station de travail, serveur ou contrôleur de domaine.
-
-
Site
-
-
Type d'accès : Lecture seule
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_Site( [out] BSTR* pbstrSite );
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.
-
-
StorageCapacité
-
-
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 );
Taille, en mégaoctets, du disque.
-
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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| DLL |
|
| IID |
IID_IADsComputer est défini comme EFE3CC70-1D9F-11CF-B1F3-02608C9E7553 |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour