Interface IWbemHiPerfProvider

Interface IWbemHiPerfProvider

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 IWbemHiPerfProvider interface is .

Methods in Vtable Order

IUnknown Methods	Description
Addref	Determines if the current object supports a given interface.
QueryInterface	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.

IWbemHiPerfProvider Methods	Description
Initialize	Creates namespaces.
QueryInstances	TBD
CreateRefresher	TBD
CreateRefreshableObject	TBD
StopRefreshing	TBD
SendChangeNotifications	TBD

IWbemHiPerfProvider::QueryInterface

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

[This is preliminary documentation and subject to change.]

The IWbemHiPerfProvider::QueryInterface method determines if the object supports a particular COM interface. If it does, the system increases the object's reference count, which means the application can use that interface immediately.

HRESULT IWbemHiPerfProvider::QueryInterface(

[in] REFIID riid,

[out] LPVOID *ppv

);

Parameters

riid

The COM interface identifier of the requested interface.

obp

Address of a pointer that will be 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. If the call fails because the requested interface was not supported, 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.

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

IWbemHiPerfProvider::AddRef

THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1!

[This is preliminary documentation and subject to change.]

The IWbemHiPerfProvider::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 Releasemethod 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

IWbemHiPerfProvider::Release

THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1!

[This is preliminary documentation and subject to change.]

The IWbemHiPerfProvider::Release method decreases the object's reference count by 1.

ULONG IWbemHiPerfProvider::Release( );

Parameters

None.

Return Values

Returns the new reference count.

Remarks

The object deallocates itself when its reference count reaches zero. Use the AddRefmethod 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

IWbemHiPerfProvider::Initialize

THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1!

[This is preliminary documentation and subject to change.]

The IWbemHiPerfProvider::Initialize method creates namespaces.

HRESULT IWbemHiPerfProvider::Initialize(

[in, string] WCHAR *wszNamespace,

[in, string] WCHAR *wszUser,

[in] IWbemServices *pNamespace,

[in] LONG lFlags

[in] IWbemContext *pContext

);

Parameters

wszNamespace

The namespace being initialized.

wszUser

TBD..

pNamespace

An IWbemServicespointer back into CIMOM which is capable of servicing any requests made by the provider. The provider should AddRefthis pointer if it is going to need to call back into CIMOM during its execution.

lFlags

Reserved. It must be zero.

pContext

TBD.

Return Values

Remarks

See Also

IWbemHiPerfProvider::QueryInstances

THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1!

[This is preliminary documentation and subject to change.]

The IWbemHiPerfProvider::QueryInstances method TBD

HRESULT IWbemHiPerfProvider::QueryInstances(

[in] IWbemServices *pNamespace,

[in, string] WCHAR *wszClass,

[in] LONG lFlags,

[in] IWbemContext *pCtx,

[in] IWbemObjectSink *pSink

);

Parameters

pNamespace

An IWbemServices pointer back into CIMOM which is capable of servicing any requests made by the provider. The provider should AddRef this pointer if it is going to need to call back into CIMOM during its execution.

wszClass

TBD.

lFlags

Reserved. It must be zero.

pCtx

Typically NULL. Otherwise, this is a pointer to an IWbemContext object required by the dynamic class provider that is producing the class instances. The values in the context object must be specified in the documentation for the provider in question.

pSink

The pointer to the IWbemObjectSink implementation provided by the client to any of the asynchronous methods of IWbemServices.

Return Values

Remarks

See Also

IWbemHiPerfProvider::CreateRefresher

THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1!

[This is preliminary documentation and subject to change.]

The IWbemHiPerfProvider::CreateRefresher method TBD

HRESULT IWbemHiPerfProvider::CreateRefreshableObject(

[in] IWbemServices *pNamespace,

[in] LONG lFlags,

[out] IWbemRefresher **ppRefresher

);

Parameters

pNamespace

An IWbemServices pointer back into CIMOM which is capable of servicing any requests made by the provider. The provider should AddRef this pointer if it is going to need to call back into CIMOM during its execution.

lFlags

Reserved. It must be zero.

ppRefresher

TBD.

Return Values

Remarks

See Also

IWbemHiPerfProvider::CreateRefreshableObject

THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1!

[This is preliminary documentation and subject to change.]

The IWbemHiPerfProvider::CreateRefreshableObject method TBD

HRESULT IWbemHiPerfProvider::CreateRefreshableObject(

[in] IWbemServices *pNamespace,

[in] IWbemObjectAccess *pTemplate,

[in] IWbemRefresher *pRefresher,

[in] LONG lFlags,

[in] IWbemContext *pContext,

[out] IWbemObjectAccess **ppRefreshable,

[out] LONG *plId

);

Parameters

pNamespace

An IWbemServices pointer back into CIMOM which is capable of servicing any requests made by the provider. The provider should AddRef this pointer if it is going to need to call back into CIMOM during its execution.

pTemplate

TBD.

pRefresher

TBD.

LFlags

Reserved. It must be zero.

pContext

TBD.

ppRefreshable

TBD.

plId

Pointer to a LONG that receives the interface identifier (IID).

Return Values

Remarks

See Also

IWbemHiPerfProvider::StopRefreshing

THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1!

[This is preliminary documentation and subject to change.]

The IWbemHiPerfProvider::StopRefreshing method TBD

HRESULT IWbemHiPerfProvider::StopRefreshing(

[in] IWbemRefresher *pRefresher,

[in] LONG *lId,

[in] LONG *lFlags

);

Parameters

pRefresher

TBD.

lId

TBD.

lFlags

Reserved. It must be zero.

Return Values

Remarks

See Also

IWbemHiPerfProvider::SendChangeNotifications

THIS HAS BEEN COMMENTED OUT! IT IS NOT TO BE PUBLISHED IN WBEM VERSION 1!! I HAVE RETAINED IT HERE FOR VERSION 1.1!

[This is preliminary documentation and subject to change.]

The IWbemHiPerfProvider::SendChangeNotifications method TBD

HRESULT IWbemHiPerfProvider::SendChangeNotifications(

[in] IWbemServices *pNamespace,

[in] LONG *lFlags,

[in] LONG *lEventTypes,

[in] IWbemContext *pContext,

[in] IWbemChangeSink *pSink

);

Parameters

pNamespace

An IWbemServices pointer back into CIMOM which is capable of servicing any requests made by the provider. The provider should AddRef this pointer if it is going to need to call back into CIMOM during its execution

lFlags

Reserved. It must be zero.

alEventTypes

TBD.

pContext

TBD.

pSink

The pointer to the IWbemObjectSink implementation provided by the client to any of the asynchronous methods of IWbemServices.

Return Values

Remarks