Interface IWbemObjectAccess
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS INTERFACE AND ALL ITS ASSOCIATED METHODS HAVE BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1! The IWbemObjectAccess interface is used to
Methods in Vtable Order
| IUnknown Methods | Description |
| QueryInterface | Determines if the current object supports a given interface. |
| Addref | Increases the object's reference count by 1. |
| Release | Decrements the object's reference count by 1, and frees the object when the reference count is zero. |
| IWbemObjectAccess Methods | Description |
| GetPropertyHandle | TBD |
| WritePropertyValue | TBD |
| ReadPropertyValue | TBD |
| ReadDWORD | TBD |
| WriteDWORD | TBD |
| ReadQWORD | TBD |
| WriteQWORD | TBD |
| GetPropertyInfoByHandle | TBD |
| Lock | TBD |
| Unlock | TBD |
IWbemObjectAccess::QueryInterface
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::QueryInterface method determines if the object supports a particular COM interface. If it does, the system increases the object's reference count, and the application can use that interface immediately.
HRESULT IWbemObjectAccess::QueryInterface(
[in] REFIID riid,
[out] LPVOID *ppv
);
Parameters
riid
The COM interface identifier of the requested interface.
obp
Address of a pointer that is filled with the interface pointer if the query succeeds.
Return Values
Returns standard COM error codes for QueryInterface. It returns WBEM_S_NO_ERROR if the call succeeds. This call will fail if the requested interface was not supported and the method returns E_NOINTERFACE.
Remarks
When the application no longer needs the interface retrieved by a call to this method, it must call the Release method for that interface to free it. The QueryInterface method allows the extension of objects without interfering with each object's existing or future functionality.
The QueryInterface method is part of the IUnknown interface inherited by the object. For more information about this method, see the COM documentation in the Microsoft Platform SDK.
See Also
IUnknown Programming Basics
IWbemObjectAccess::AddRef
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::AddRef method increases the object's reference count by 1.
ULONG AddRef( );
Parameters
None.
Return Values
Returns the new reference count.
Remarks
When the object is created, its reference count is set to 1. Every time an application obtains an interface to the object or calls the AddRef method, the object's reference count is increased by 1. Use the Release_hmm_IWbemObjectAccess_Release method to decrease the object's reference count by 1.
This method is part of the IUnknown interface inherited by the object. For a complete discussion of IUnknown methods, see IUnknown Programming Basics.
For more information about this method, see the COM documentation in the Microsoft Platform SDK.
See Also
IUnknown Programming Basics
IWbemObjectAccess::Release
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::Release method decreases the object's reference count by 1.
ULONG IWbemObjectAccess::Release( );
Parameters
None.
Return Values
Returns the new reference count.
Remarks
The object deallocates itself when its reference count reaches zero. Use the AddRef_hmm_IWbemObjectAccess_AddRef method to increase the object's reference count by 1.
This method is part of the IUnknown interface inherited by the object. For more information about this method, see the COM documentation in the Microsoft Platform SDK.
See Also
IUnknown Programming Basics
IWbemObjectAccess::GetPropertyHandle
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::GetPropertyHandle method TBD
HRESULT IWbemObjectAccess::GetPropertyHandle(
[in] BSTR strPropertyName,
[out] CIMTYPE *pType,
[out] LONG *plHandle
);
Parameters
strPropertyName
TBD.
pType
TBD.
plHandle
TBD.
Return Values
Remarks
See Also
IWbemObjectAccess::WritePropertyValue
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::WritePropertyValue method….
HRESULT IWbemObjectAccess::WritePropertyValue(
[in] LONG lHandle,
[in] LONG lNumBytes,
[in, size_is(lNumBytes)] byte *pData
);
Parameters
lHandle
TBD.
lNumBytes
TBD.
pData
TBD.
Return Values
See Also
IWbemObjectAccess::ReadPropertyValue
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::ReadPropertyValue method determines …
HRESULT IWbemObjectAccess::ReadPropertyValue(
[in] LONG lHandle,
[in] LONG lBufferSize,
[out] LONG *plNumBytes,
[out, size_is(lBufferSize), length_is(*plNumBytes)] byte *pData
);
Parameters
lHandle
TBD.
lBufferSize
TBD.
plNumBytes
TBD.
pData
TBD.
Return Values
Remarks
See Also
IWbemObjectAccess::ReadDWORD
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::ReadDWORD method
HRESULT IWbemObjectAccess::ReadDWORD(
[in] LONG lHandle,
[out] DWORD *pdw
);
Parameters
lHandle
TBD.
pdw
TBD.
Return Values
Remarks
See Also
IWbemObjectAccess::WriteDWORD
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::WriteDWORD method
HRESULT IWbemObjectAccess::WriteDWORD(
[in] LONG lHandle,
[out] DWORD dw
);
Parameters
lHandle
TBD.
dw
TBD.
Return Values
Remarks
See Also
IWbemObjectAccess::ReadQWORD
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::ReadQWORD method
HRESULT IWbemObjectAccess::ReadQWORD(
[in] LONG lHandle,
[out] unsigned__int64 *pqw
);
Parameters
lHandle
TBD.
pqw
TBD.
Return Values
Remarks
See Also
IWbemObjectAccess::WriteQWORD
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::WriteQWORD method
HRESULT IWbemObjectAccess::WriteQWORD(
[in] LONG lHandle,
[out] unsigned__int64 pw
);
Parameters
lHandle
TBD.
pw
TBD.
Return Values
Remarks
See Also
IWbemObjectAccess::GetPropertyInfoByHandle
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::GetPropertyInfoByHandle method
HRESULT IWbemObjectAccess::GetPropertyInfoByHandle(
[in] LONG lHandle,
[out] BSTR *pstrName,
[out] CIMTYPE *pType
);
Parameters
lHandle
TBD.
pstrName
TBD.
pType
TBD.
Return Values
Remarks
See Also
IWbemObjectAccess::Lock
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::Lock method
HRESULT IWbemObjectAccess::Lock(
[in] LONG lFlags
);
Parameters
lFlags
Reserved. It must be zero.
Return Values
Remarks
See Also
IWbemObjectAccess::UnLock
<span style=color:#FF0000>[This is preliminary documentation and subject to change.]</span>
THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1
The IWbemObjectAccess::UnLock method TBD
HRESULT IWbemObjectAccess::UnLock(
[in] LONG lFlags
);
Parameters
lFlags
Reserved. It must be zero.
Return Values
Remarks
See Also›