다음을 통해 공유


IWbemObjectAccess 인터페이스(wbemcli.h)

IWbemObjectAccess 인터페이스는 개체의 메서드 및 속성에 대한 액세스를 제공합니다. IWbemObjectAccess 개체는 리프레셔에서 업데이트한 인스턴스의 컨테이너입니다. IWbemObjectAccess 인터페이스를 사용하면 개체 속성 이름 대신 속성 핸들을 사용하여 속성을 가져와서 설정할 수 있습니다.

참고 이 인터페이스는 어떤 상황에서도 클라이언트 애플리케이션 또는 공급자에 의해 구현되지 않습니다. WMI에서 제공하는 구현은 지원되는 유일한 구현입니다. IWbemClassObject::QueryInterface를 호출하여 인터페이스에 대한 포인터를 검색할 수 있습니다.
 

상속

IWbemObjectAccess 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IWbemObjectAccess 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IWbemObjectAccess 인터페이스에는 이러한 메서드가 있습니다.

 
IWbemObjectAccess::GetPropertyHandle

GetPropertyHandle 메서드는 속성을 식별하는 고유 핸들을 반환합니다. IWbemObjectAccess 메서드를 사용하여 속성 값을 읽거나 쓸 때 이 핸들을 사용하여 속성을 식별할 수 있습니다.
IWbemObjectAccess::GetPropertyInfoByHandle

GetPropertyInfoByHandle 메서드는 속성 핸들과 연결된 속성의 이름 및 데이터 형식을 반환합니다.
IWbemObjectAccess::Lock

Lock 메서드는 잠금 해제될 때까지 다른 스레드가 IWbemObjectAccess 개체를 업데이트하지 못하도록 합니다.
IWbemObjectAccess::ReadDWORD

ReadDWORD 메서드는 속성 핸들을 사용하여 32비트 속성 데이터를 읽습니다.
IWbemObjectAccess::ReadPropertyValue

ReadPropertyValue 메서드는 속성 핸들과 연결된 속성의 지정된 바이트 수를 반환합니다.
IWbemObjectAccess::ReadQWORD

ReadQWORD 메서드는 속성 핸들로 식별된 64비트 속성 데이터를 읽습니다.
IWbemObjectAccess::Unlock

Unlock 메서드를 사용하면 다른 스레드가 IWbemObjectAccess 개체의 속성 값을 업데이트할 수 있습니다.
IWbemObjectAccess::WriteDWORD

WriteDWORD 메서드는 속성 핸들로 식별되는 속성에 32비트 데이터를 씁니다.
IWbemObjectAccess::WritePropertyValue

WritePropertyValue 메서드는 속성 핸들로 식별된 속성에 지정된 바이트 수를 씁니다. 이 메서드를 사용하여 문자열 및 다른 모든 비 DWORD 또는 비 QWORD 데이터를 설정합니다.
IWbemObjectAccess::WriteQWORD

WriteQWORD 메서드는 속성 핸들을 사용하여 속성에 64비트 데이터를 씁니다.

설명

데이터를 읽고 쓰는 IWbemObjectAccess 메서드는 데이터 유효성 검사를 거의 수행하지 않습니다. IWbemObjectAccess 메서드는 속성에 직접 액세스하므로 IWbemClassObject::Get 및 IWbemClassObject::P ut과 같은 표준 개체 액세스 기술을 사용하는 것보다 훨씬 더 빠르게 속성을 가져와서 설정할 수 있습니다.

참고 속도를 최대화하기 위해 IWbemObjectAccess 는 완전히 선택 취소됩니다. 모든 핸들이 적절하고 쓰기 버퍼의 크기가 올바르게 조정되도록 하는 것은 사용자의 책임입니다. 읽기 및 쓰기 작업은 본질적으로 스레드로부터 안전하지 않습니다. IWbemObjectAccess 개체가 여러 스레드에서 동시에 액세스하지 못하도록 하려면 IWbemObjectAccess::Lock 및 IWbemObjectAccess::Unlock 메서드를 호출해야 합니다.
 
속성 핸들은 클래스의 모든 인스턴스에 대해 동일합니다. 따라서 핸들을 한 번만 검색하면 됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 wbemcli.h(Wbemidl.h 포함)

추가 정보

C++에서 성능 데이터 액세스

WMI 사전 설치 성능 클래스에 액세스

WMI용 COM API

IWbemRefresher