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 포함) |