IADsComputer プロパティ メソッド

IADsComputer インターフェイス メソッドは、このトピックで説明するプロパティの読み取りと書き込みを行います。 詳細については、「インターフェイス プロパティ メソッド」を参照してください。

プロパティ

ComputerID

各コンピューターに割り当てられるグローバル一意識別子。

アクセスの種類: 読み取り専用

スクリプト データ型: BSTR

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

課

このコンピューターが属する部署などの組織単位 (OU)。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

説明

このコンピューターの説明。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

除算

組織内で、このコンピューターが属する部門。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

場所

このコンピューターの割り当てられた物理的な場所。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

MemorySize

このコンピューターのランダム アクセス メモリのサイズ (メガバイト単位)。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

モデル

このコンピューターの作成とモデル。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

NetAddresses

このコンピューターに到達できるアドレスを表す NetAddress フィールドの配列。 NetAddress は、コロン (:) で区切られた 2 つの部分文字列で構成されるプロバイダー固有 の BSTR です。 左部分文字列はアドレスの種類を示し、右側の部分文字列はその型のアドレスの文字列表現です。 たとえば、TCP/IP アドレスの形式は IP:100.201.301.45 です。 IPX 型アドレスの形式は IPX:10.123456.80 です。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: VARIANT

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

OperatingSystem

このコンピューターで使用されるオペレーティング システム。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

OperatingSystemVersion

このコンピューターで使用されるオペレーティング システムのバージョン。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

所有者

このコンピューターが割り当てられているユーザー。 このユーザーには、インストールされているソフトウェアを実行するためのライセンスも必要です。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

PrimaryUser

このコンピューターの管理者などの連絡先の名前。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

プロセッサ

プロセッサの種類。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

ProcessorCount

インストールされているプロセッサの数。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

Role

このコンピューターの役割 (ワークステーション、サーバー、doメイン コントローラーなど)。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

サイト

このコンピューターがインストールされたサイトを識別するグローバル一意識別子。 サイトは、ネットワーク内の良好な接続の物理的な領域です。

アクセスの種類: 読み取り専用

スクリプト データ型: BSTR

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

StorageCapacity

ディスクのサイズ (メガバイト単位)。

アクセスの種類: 読み取り/書き込み

スクリプト データ型: BSTR

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

解説

プロバイダーによって、コンピューター オブジェクトのさまざまなプロパティを公開することを選択できます。 詳細については、「ADSI システム プロバイダー」を参照してください。

スキーマ クラスを使用して必須プロパティと省略可能なプロパティを調べることで、サポートされているプロパティを確認できます。 詳細については、IADsClass インターフェイスを参照してください。

コンピューターの状態を調べたり、ネットワーク経由でシャットダウン操作を実行したりするには、IADsComputerOperations インターフェイスを使用する必要があります。

例

次の Visual Basic コード例では、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

次の C++ コード例では、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;

要件

関連項目

IADsComputer

ADSI システム プロバイダー

IADsClass

IADsComputerOperations

Interface プロパティ メソッド