다음을 통해 공유

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
);

사업부

이 컴퓨터가 속한 organization 내의 부서입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: 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

이 컴퓨터의 임의 액세스 메모리 크기(MB)입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: 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는 콜론(:) 구분된 두 개의 부분 문자열로 구성된 공급자별 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
);

역할

이 컴퓨터의 역할(예: 워크스테이션, 서버 또는 도메인 컨트롤러).

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: 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;

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista
지원되는 최소 서버
 Windows Server 2008
헤더
Iads.h
DLL
Activeds.dll
IID
 IID_IADsComputer EFE3CC70-1D9F-11CF-B1F3-02608C9E7553으로 정의됩니다.

추가 정보

IADsComputer

ADSI 시스템 공급자

IADsClass

IADsComputerOperations

Interface 속성 메서드