You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1013 lines
28 KiB
1013 lines
28 KiB
|
|
/*++
|
|
|
|
Copyright (C) 1996-1999 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
WBEMINT.IDL
|
|
|
|
Abstract:
|
|
|
|
CIMOM Interfaces
|
|
|
|
History:
|
|
|
|
--*/
|
|
|
|
import "objidl.idl";
|
|
import "oleidl.idl";
|
|
import "oaidl.idl";
|
|
import "wbemtran.idl";
|
|
import "wbemprov.idl";
|
|
|
|
typedef VARIANT WBEM_VARIANT;
|
|
typedef [string] WCHAR* WBEM_WSTR;
|
|
typedef [string] const WCHAR* WBEM_CWSTR;
|
|
|
|
#define OPTIONAL in, unique
|
|
|
|
//==============================================================================
|
|
//
|
|
// IWbemPropertySource
|
|
//
|
|
// Makes the object look like a property set to enable condition testing
|
|
// (see IWbemCondition below). It is useful when a provider wants to test a
|
|
// a condition without the expense of constructing IWbemClassObject.
|
|
//
|
|
// Used: by WBEMOM inside standard IWbemCondition implementation
|
|
// Implemented: by providers who wish to check if their objects satisfy a
|
|
// condition without constructing IWbemClassObjects.
|
|
//
|
|
//==============================================================================
|
|
//
|
|
// GetPropertyValue
|
|
//
|
|
// Retrieves the value of a property by name. In the case where embedded
|
|
// objects may be present, the name can be a complex one, e.g.
|
|
// "OldVersion.Manufacturer".
|
|
//
|
|
// PARAMETERS:
|
|
//
|
|
// WCHAR wszPropertyName The name of the property to retrieve
|
|
// long lFlags Reserved. For future compatibility, use 0.
|
|
// WBEM_VARIANT* pvValue Destination for the value of the property. The
|
|
// caller must VariantClear it on success.
|
|
// RETURNS:
|
|
//
|
|
// WBEM_S_NO_ERROR On Success
|
|
// WBEM_E_NOT_FOUND No such property
|
|
// WBEM_E_NOT_AVAILABLE The value is not available. Condition
|
|
// evaluators should attempt to evaluate the
|
|
// condition without it.
|
|
// WBEM_E_FAILED Other critical error.
|
|
//
|
|
//==============================================================================
|
|
|
|
typedef enum
|
|
{
|
|
WBEM_NAME_ELEMENT_TYPE_PROPERTY = 0,
|
|
WBEM_NAME_ELEMENT_TYPE_INDEX = 1
|
|
} WBEM_NAME_ELEMENT_TYPE;
|
|
|
|
typedef [switch_type(short)] union tag_NameElementUnion
|
|
{
|
|
[case(WBEM_NAME_ELEMENT_TYPE_PROPERTY)] WBEM_WSTR m_wszPropertyName;
|
|
[case(WBEM_NAME_ELEMENT_TYPE_INDEX)] long m_lArrayIndex;
|
|
} WBEM_NAME_ELEMENT_UNION;
|
|
|
|
typedef struct tag_NameElement
|
|
{
|
|
short m_nType;
|
|
[switch_is(m_nType)] WBEM_NAME_ELEMENT_UNION Element;
|
|
} WBEM_NAME_ELEMENT;
|
|
|
|
typedef struct _tag_WbemPropertyName
|
|
{
|
|
long m_lNumElements;
|
|
[size_is(m_lNumElements)] WBEM_NAME_ELEMENT* m_aElements;
|
|
} WBEM_PROPERTY_NAME;
|
|
|
|
[restricted, object, uuid(e2451054-b06e-11d0-ad61-00c04fd8fdff)]
|
|
interface IWbemPropertySource : IUnknown
|
|
{
|
|
HRESULT GetPropertyValue(
|
|
[in] WBEM_PROPERTY_NAME* pName,
|
|
[in] long lFlags,
|
|
[in, unique, out] WBEM_WSTR* pwszCimType,
|
|
[out] WBEM_VARIANT* pvValue);
|
|
HRESULT InheritsFrom([in] WBEM_CWSTR wszClassName);
|
|
};
|
|
|
|
//==============================================================================
|
|
//
|
|
// QL operators
|
|
//
|
|
//==============================================================================
|
|
|
|
|
|
typedef enum _tag_Ql1ComparisonOperator
|
|
{
|
|
QL1_OPERATOR_NONE = 0,
|
|
QL1_OPERATOR_EQUALS = 1,
|
|
QL1_OPERATOR_NOTEQUALS,
|
|
QL1_OPERATOR_GREATER,
|
|
QL1_OPERATOR_LESS,
|
|
QL1_OPERATOR_LESSOREQUALS,
|
|
QL1_OPERATOR_GREATEROREQUALS,
|
|
QL1_OPERATOR_LIKE,
|
|
QL1_OPERATOR_UNLIKE,
|
|
QL1_OPERATOR_ISA,
|
|
QL1_OPERATOR_ISNOTA,
|
|
QL1_OPERATOR_INV_ISA,
|
|
QL1_OPERATOR_INV_ISNOTA,
|
|
} WBEM_QL1_COMPARISON_OPERATOR;
|
|
|
|
typedef enum _tag_Ql1Function
|
|
{
|
|
QL1_FUNCTION_NONE = 0,
|
|
QL1_FUNCTION_UPPER,
|
|
QL1_FUNCTION_LOWER
|
|
} WBEM_QL1_FUNCTION;
|
|
|
|
typedef enum _tag_Ql1TokenType
|
|
{
|
|
QL1_NONE = 0,
|
|
QL1_OR = 1,
|
|
QL1_AND,
|
|
QL1_NOT,
|
|
QL1_OP_EXPRESSION
|
|
} WBEM_QL1_TOKEN_TYPE;
|
|
|
|
typedef struct _tag_WbemQl1Token
|
|
{
|
|
long m_lTokenType; // WbemSql1TokenType
|
|
|
|
WBEM_PROPERTY_NAME m_PropertyName;
|
|
WBEM_PROPERTY_NAME m_PropertyName2;
|
|
long m_lOperator; // WbemSql1ComparisonOperator
|
|
WBEM_VARIANT m_vConstValue;
|
|
long m_lPropertyFunction; // WbemSql1Function
|
|
long m_lConstFunction; // WbemSql1Function
|
|
long m_bQuoted;
|
|
long m_bPropComp;
|
|
} WBEM_QL1_TOKEN;
|
|
|
|
typedef struct _tag_WbemQl1Tolerance
|
|
{
|
|
boolean m_bExact;
|
|
double m_fTolerance;
|
|
} WBEM_QL1_TOLERANCE;
|
|
|
|
typedef enum tag_WBEM_EVENT_TYPE{
|
|
WBEM_EVENTTYPE_Invalid = 0,
|
|
WBEM_EVENTTYPE_Extrinsic = 5,
|
|
WBEM_EVENTTYPE_Timer,
|
|
WBEM_EVENTTYPE_NamespaceCreation,
|
|
WBEM_EVENTTYPE_NamespaceDeletion,
|
|
WBEM_EVENTTYPE_NamespaceModification,
|
|
WBEM_EVENTTYPE_ClassCreation,
|
|
WBEM_EVENTTYPE_ClassDeletion,
|
|
WBEM_EVENTTYPE_ClassModification,
|
|
WBEM_EVENTTYPE_InstanceCreation,
|
|
WBEM_EVENTTYPE_InstanceDeletion,
|
|
WBEM_EVENTTYPE_InstanceModification,
|
|
WBEM_EVENTTYPE_System
|
|
} WBEM_EVENT_TYPE;
|
|
|
|
//==============================================================================
|
|
//==============================================================================
|
|
//
|
|
// Event-provider specific interfaces.
|
|
//
|
|
//==============================================================================
|
|
//==============================================================================
|
|
|
|
[restricted, object, local, uuid(a658b5d6-021d-11d1-ad74-00c04fd8fdff)]
|
|
interface IWbemDecorator : IUnknown
|
|
{
|
|
HRESULT DecorateObject([in] IWbemClassObject* pObject,
|
|
WBEM_CWSTR wszNamespace);
|
|
HRESULT UndecorateObject([in] IWbemClassObject* pObject);
|
|
};
|
|
|
|
[restricted, object, local, uuid(a658b6d6-021d-11d1-ad74-00c04fd8fdff)]
|
|
interface IWbemLifeControl : IUnknown
|
|
{
|
|
HRESULT AddRefCore();
|
|
HRESULT ReleaseCore();
|
|
};
|
|
|
|
[restricted, object, uuid(a553f3f0-3805-11d0-b6b2-00aa003240c7)]
|
|
interface IWbemEventSubsystem_m4 : IUnknown
|
|
{
|
|
HRESULT ProcessInternalEvent(
|
|
[in] LONG lSendType,
|
|
[in] BSTR strReserved1,
|
|
[in] BSTR strReserved2,
|
|
[in] BSTR strReserved3,
|
|
[in] unsigned long dwReserved1,
|
|
[in] unsigned long dwReserved2,
|
|
[in] unsigned long dwNumObjects,
|
|
[in, size_is(dwNumObjects)] IWbemClassObject** apObjects,
|
|
[in] IWbemContext* pContext
|
|
);
|
|
|
|
HRESULT VerifyInternalEvent(
|
|
[in] LONG lSendType,
|
|
[in] BSTR strReserved1,
|
|
[in] BSTR strReserved2,
|
|
[in] BSTR strReserved3,
|
|
[in] unsigned long dwReserved1,
|
|
[in] unsigned long dwReserved2,
|
|
[in] unsigned long dwNumObjects,
|
|
[in, size_is(dwNumObjects)] IWbemClassObject** apObjects,
|
|
[in] IWbemContext* pContext
|
|
);
|
|
|
|
HRESULT RegisterNotificationSink(
|
|
[in] WBEM_CWSTR wszNamespace,
|
|
[in] WBEM_CWSTR wszQueryLanguage,
|
|
[in] WBEM_CWSTR wszQuery,
|
|
[in] long lFlags,
|
|
[in] IWbemContext* pContext,
|
|
[in] IWbemObjectSink* pSink);
|
|
|
|
HRESULT RemoveNotificationSink(
|
|
[in] IWbemObjectSink* pSink);
|
|
|
|
HRESULT GetNamespaceSink(
|
|
[in] WBEM_CWSTR wszNamespace,
|
|
[out] IWbemObjectSink** ppNamespaceSink);
|
|
|
|
HRESULT Initialize(
|
|
[in] WBEM_CWSTR wszServerName,
|
|
[in] IWbemLocator* pAdminLocator,
|
|
[in] IUnknown* pServices);
|
|
|
|
HRESULT Shutdown();
|
|
HRESULT LastCallForCore();
|
|
};
|
|
|
|
|
|
[object, restricted, uuid(6c19be32-7500-11d1-ad94-00c04fd8fdff)]
|
|
interface IWbemMetaData : IUnknown
|
|
{
|
|
HRESULT GetClass(
|
|
[in, string] LPCWSTR wszClassName,
|
|
[in] IWbemContext* pContext,
|
|
[out] IWbemClassObject** ppClass);
|
|
};
|
|
|
|
typedef DWORD WBEM_REMOTE_TARGET_ID_TYPE;
|
|
|
|
typedef struct tag_WBEM_REM_TARGETS
|
|
{
|
|
long m_lNumTargets;
|
|
[size_is(m_lNumTargets)] WBEM_REMOTE_TARGET_ID_TYPE* m_aTargets;
|
|
} WBEM_REM_TARGETS;
|
|
|
|
[object, restricted, uuid(755f9da6-7508-11d1-ad94-00c04fd8fdff)]
|
|
interface IWbemMultiTarget : IUnknown
|
|
{
|
|
HRESULT DeliverEvent(
|
|
[in] ULONG dwNumEvents,
|
|
[in, size_is(dwNumEvents)] IWbemClassObject** aEvents,
|
|
[in, size_is(dwNumEvents)] WBEM_REM_TARGETS* aTargets);
|
|
|
|
HRESULT DeliverStatus(
|
|
[in] long lFlags,
|
|
[in] HRESULT hresStatus,
|
|
[in, string] LPCWSTR wszStatus,
|
|
[in] IWbemClassObject* pErrorObj,
|
|
[in] WBEM_REM_TARGETS* pTargets);
|
|
};
|
|
|
|
[object, restricted, uuid(755f9da7-7508-11d1-ad94-00c04fd8fdff)]
|
|
interface IWbemEventProviderRequirements : IUnknown
|
|
{
|
|
HRESULT DeliverProviderRequest(
|
|
[in] long lFlags);
|
|
};
|
|
|
|
// Smart MultiTarget Interface for removal of redundant
|
|
// class data
|
|
|
|
[object, restricted, uuid(37196B38-CCCF-11d2-B35C-00105A1F8177)]
|
|
interface IWbemSmartMultiTarget : IUnknown
|
|
{
|
|
HRESULT DeliverEvent(
|
|
[in] ULONG dwNumEvents,
|
|
[in] ULONG dwBuffSize,
|
|
[in, size_is(dwBuffSize)] byte* pBuffer,
|
|
[in, size_is(dwNumEvents)] WBEM_REM_TARGETS* pTargets);
|
|
|
|
};
|
|
|
|
//
|
|
// IWbemFetchSmartMultiTarget
|
|
//
|
|
// This Interface is used to return a smart multi-target. It assists
|
|
// us when we need to get an enumerator but want to do so without
|
|
// causing AddRef problem with the Proxy Manager.
|
|
//
|
|
|
|
[restricted, object, uuid(37196B39-CCCF-11d2-B35C-00105A1F8177)]
|
|
interface IWbemFetchSmartMultiTarget : IUnknown
|
|
{
|
|
HRESULT GetSmartMultiTarget(
|
|
[out] IWbemSmartMultiTarget** ppSmartMultiTarget
|
|
);
|
|
};
|
|
|
|
/* NO LONGER SUPPORTED AS OF M3
|
|
|
|
typedef enum tag_WBEM_FILTER_TARGET_TYPE
|
|
{
|
|
WBEM_FILTER_TARGET_TYPE_NONE,
|
|
WBEM_FILTER_TARGET_TYPE_INTERNAL,
|
|
WBEM_FILTER_TARGET_TYPE_MARSHALLED,
|
|
WBEM_FILTER_TARGET_TYPE_LOADABLE,
|
|
} WBEM_FILTER_TARGET_TYPE;
|
|
|
|
typedef struct tag_WBEM_FILTER_TARGET_LOAD_INFO
|
|
{
|
|
CLSID m_clsidConsumerProvider;
|
|
IWbemClassObject* m_pLogicalConsumer;
|
|
IWbemUnboundObjectSink* m_pCached;
|
|
} WBEM_FILTER_TARGET_LOAD_INFO;
|
|
|
|
typedef struct tag_WBEM_FILTER_TARGET_MARSHALLED_INFO
|
|
{
|
|
IWbemUnboundObjectSink* m_pSink;
|
|
IWbemClassObject* m_pLogicalConsumer;
|
|
} WBEM_FILTER_TARGET_MARSHALLED_INFO;
|
|
|
|
|
|
typedef [switch_type(long)] union tag_WBEM_FILTER_TARGET_DATA
|
|
{
|
|
[case(WBEM_FILTER_TARGET_TYPE_INTERNAL)]
|
|
WBEM_REMOTE_TARGET_ID_TYPE m_ID;
|
|
|
|
[case(WBEM_FILTER_TARGET_TYPE_MARSHALLED)]
|
|
WBEM_FILTER_TARGET_MARSHALLED_INFO m_MarshInfo;
|
|
|
|
[case(WBEM_FILTER_TARGET_TYPE_LOADABLE)]
|
|
WBEM_FILTER_TARGET_LOAD_INFO m_LoadInfo;
|
|
|
|
[default]
|
|
;
|
|
} WBEM_FILTER_TARGET_DATA;
|
|
|
|
typedef struct tag_WBEM_FILTER_TARGET
|
|
{
|
|
long m_lType;
|
|
[switch_is(m_lType)] WBEM_FILTER_TARGET_DATA m_Data;
|
|
boolean m_bSynch;
|
|
} WBEM_FILTER_TARGET;
|
|
|
|
typedef struct tag_WBEM_FILTER_TARGETS
|
|
{
|
|
long m_lNumTargets;
|
|
[size_is(m_lNumTargets)] WBEM_FILTER_TARGET* m_aTargets;
|
|
} WBEM_FILTER_TARGETS;
|
|
*/
|
|
|
|
[object, restricted, uuid(60e512d4-c47b-11d2-b338-00105a1f4aaf)]
|
|
interface IWbemFilterProxy : IUnknown
|
|
{
|
|
HRESULT Initialize(
|
|
[in] IWbemMetaData* pMetaData,
|
|
[in] IWbemMultiTarget* pMultiTarget);
|
|
|
|
HRESULT Lock();
|
|
|
|
HRESULT Unlock();
|
|
|
|
HRESULT AddFilter(
|
|
[in] IWbemContext* pContext,
|
|
[in, string] LPCWSTR wszQuery,
|
|
[in] WBEM_REMOTE_TARGET_ID_TYPE Id);
|
|
|
|
HRESULT RemoveFilter(
|
|
[in] IWbemContext* pContext,
|
|
[in] WBEM_REMOTE_TARGET_ID_TYPE Id);
|
|
|
|
HRESULT RemoveAllFilters(
|
|
[in] IWbemContext* pContext);
|
|
|
|
HRESULT AddDefinitionQuery(
|
|
[in] IWbemContext* pContext,
|
|
[in] LPCWSTR wszQuery);
|
|
|
|
HRESULT RemoveAllDefinitionQueries(
|
|
[in] IWbemContext* pContext);
|
|
|
|
HRESULT Disconnect();
|
|
};
|
|
|
|
[object, restricted, uuid(6c19be34-7500-11d1-ad94-00c04fd8fdff)]
|
|
interface IWbemFilterStub : IUnknown
|
|
{
|
|
HRESULT RegisterProxy(
|
|
[in] IWbemFilterProxy* pProxy);
|
|
|
|
HRESULT UnregisterProxy(
|
|
[in] IWbemFilterProxy* pProxy);
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
typedef GUID REQUESTID;
|
|
|
|
[restricted, object, uuid(a57be31e-efe3-11d0-ad71-00c04fd8fdff)]
|
|
interface IWbemCausalityAccess : IUnknown
|
|
{
|
|
HRESULT GetRequestId([out] REQUESTID* pId);
|
|
HRESULT IsChildOf([in] REQUESTID Id);
|
|
HRESULT CreateChild([out] IWbemCausalityAccess** ppChild);
|
|
HRESULT GetParentId([out] REQUESTID* pId);
|
|
HRESULT GetHistoryInfo([out] long* plNumParents, [out] long* plNumSiblings);
|
|
HRESULT MakeSpecial();
|
|
HRESULT IsSpecial();
|
|
};
|
|
|
|
//==============================================================================
|
|
//==============================================================================
|
|
//
|
|
// Hi-perf specific interfaces.
|
|
//
|
|
//==============================================================================
|
|
//==============================================================================
|
|
|
|
typedef enum _WBEM_INSTANCE_BLOB_TYPE
|
|
{
|
|
WBEM_BLOB_TYPE_DATA_TABLE_ONLY,
|
|
WBEM_BLOB_TYPE_DATA_AND_HEAP,
|
|
WBEM_BLOB_TYPE_ALL,
|
|
WBEM_BLOB_TYPE_ERROR, // m_lBlobLength contains error code
|
|
WBEM_BLOB_TYPE_ENUM
|
|
} WBEM_INSTANCE_BLOB_TYPE;
|
|
|
|
typedef struct _WBEM_REFRESHED_OBJECT
|
|
{
|
|
long m_lRequestId;
|
|
long m_lBlobType;
|
|
long m_lBlobLength;
|
|
[size_is(m_lBlobLength)] byte* m_pbBlob;
|
|
} WBEM_REFRESHED_OBJECT;
|
|
|
|
[restricted, uuid(F1E9C5B2-F59B-11d2-B362-00105A1F8177)]
|
|
interface IWbemRemoteRefresher : IUnknown
|
|
{
|
|
HRESULT RemoteRefresh(
|
|
[in] long lFlags,
|
|
[out] long* plNumObjects,
|
|
[out, size_is(,*plNumObjects)] WBEM_REFRESHED_OBJECT** paObjects);
|
|
|
|
HRESULT StopRefreshing(
|
|
[in] long lNumIds,
|
|
[in,size_is(lNumIds)] long* aplIds,
|
|
[in] long lFlags);
|
|
|
|
HRESULT GetGuid(
|
|
[in] long lFlags,
|
|
[out] GUID* pGuid );
|
|
};
|
|
|
|
typedef struct _WBEM_REFRESH_INFO_CLIENT_LOADABLE
|
|
{
|
|
CLSID m_clsid;
|
|
[string] WCHAR* m_wszNamespace;
|
|
IWbemObjectAccess* m_pTemplate;
|
|
} WBEM_REFRESH_INFO_CLIENT_LOADABLE;
|
|
|
|
typedef struct _WBEM_REFRESH_INFO_REMOTE
|
|
{
|
|
IWbemRemoteRefresher* m_pRefresher;
|
|
IWbemObjectAccess* m_pTemplate;
|
|
GUID m_guid;
|
|
} WBEM_REFRESH_INFO_REMOTE;
|
|
|
|
typedef struct _WBEM_REFRESH_INFO_SHARED
|
|
{
|
|
[string] WCHAR* m_wszSharedMemoryName;
|
|
IWbemRefresher* m_pRefresher;
|
|
} WBEM_REFRESH_INFO_SHARED;
|
|
|
|
typedef struct _WBEM_REFRESH_INFO_CONTINUOUS
|
|
{
|
|
[string] WCHAR* m_wszSharedMemoryName;
|
|
} WBEM_REFRESH_INFO_CONTINUOUS;
|
|
|
|
typedef struct _WBEM_REFRESH_INFO_DIRECT
|
|
{
|
|
CLSID m_clsid;
|
|
[string] WCHAR* m_wszNamespace;
|
|
IWbemObjectAccess* m_pTemplate;
|
|
IWbemHiPerfProvider* m_pProvider;
|
|
} WBEM_REFRESH_INFO_DIRECT;
|
|
|
|
typedef enum _WBEM_REFRESH_TYPE
|
|
{
|
|
WBEM_REFRESH_TYPE_INVALID,
|
|
WBEM_REFRESH_TYPE_DIRECT,
|
|
WBEM_REFRESH_TYPE_CLIENT_LOADABLE,
|
|
WBEM_REFRESH_TYPE_REMOTE,
|
|
WBEM_REFRESH_TYPE_SHARED,
|
|
WBEM_REFRESH_TYPE_CONTINUOUS
|
|
} WBEM_REFRESH_TYPE;
|
|
|
|
typedef enum _WBEM_RECONNECT_TYPE
|
|
{
|
|
WBEM_RECONNECT_TYPE_OBJECT,
|
|
WBEM_RECONNECT_TYPE_ENUM,
|
|
WBEM_RECONNECT_TYPE_LAST,
|
|
} WBEM_RECONNECT_TYPE;
|
|
|
|
typedef [switch_type(long)] union _WBEM_REFRESH_INFO_UNION
|
|
{
|
|
[case (WBEM_REFRESH_TYPE_CLIENT_LOADABLE)]
|
|
WBEM_REFRESH_INFO_CLIENT_LOADABLE m_ClientLoadable;
|
|
|
|
[case (WBEM_REFRESH_TYPE_REMOTE)]
|
|
WBEM_REFRESH_INFO_REMOTE m_Remote;
|
|
|
|
[case (WBEM_REFRESH_TYPE_SHARED)]
|
|
WBEM_REFRESH_INFO_SHARED m_Shared;
|
|
|
|
[case (WBEM_REFRESH_TYPE_CONTINUOUS)]
|
|
WBEM_REFRESH_INFO_CONTINUOUS m_Continuous;
|
|
|
|
[case (WBEM_REFRESH_TYPE_DIRECT)]
|
|
WBEM_REFRESH_INFO_DIRECT m_Direct;
|
|
|
|
[case (WBEM_REFRESH_TYPE_INVALID)]
|
|
HRESULT m_hres;
|
|
|
|
} WBEM_REFRESH_INFO_UNION;
|
|
|
|
typedef struct _WBEM_REFRESH_INFO
|
|
{
|
|
long m_lType;
|
|
[switch_is(m_lType)] WBEM_REFRESH_INFO_UNION m_Info;
|
|
long m_lCancelId;
|
|
} WBEM_REFRESH_INFO;
|
|
|
|
typedef struct _WBEM_REFRESHER_ID
|
|
{
|
|
[string] LPSTR m_szMachineName;
|
|
DWORD m_dwProcessId;
|
|
GUID m_guidRefresherId;
|
|
} WBEM_REFRESHER_ID;
|
|
|
|
typedef struct _WBEM_RECONNECT_INFO
|
|
{
|
|
long m_lType;
|
|
[string] LPCWSTR m_pwcsPath;
|
|
} WBEM_RECONNECT_INFO;
|
|
|
|
typedef struct _WBEM_RECONNECT_RESULTS
|
|
{
|
|
long m_lId;
|
|
HRESULT m_hr;
|
|
} WBEM_RECONNECT_RESULTS;
|
|
|
|
[restricted, uuid(2C9273E0-1DC3-11d3-B364-00105A1F8177)]
|
|
interface IWbemRefreshingServices : IUnknown
|
|
{
|
|
HRESULT AddObjectToRefresher(
|
|
[in] WBEM_REFRESHER_ID* pRefresherId,
|
|
[in, string] LPCWSTR wszPath,
|
|
[in] long lFlags,
|
|
[in] IWbemContext* pContext,
|
|
[in] DWORD dwClientRefrVersion,
|
|
[out] WBEM_REFRESH_INFO* pInfo,
|
|
[out] DWORD* pdwSvrRefrVersion);
|
|
|
|
HRESULT AddObjectToRefresherByTemplate(
|
|
[in] WBEM_REFRESHER_ID* pRefresherId,
|
|
[in] IWbemClassObject* pTemplate,
|
|
[in] long lFlags,
|
|
[in] IWbemContext* pContext,
|
|
[in] DWORD dwClientRefrVersion,
|
|
[out] WBEM_REFRESH_INFO* pInfo,
|
|
[out] DWORD* pdwSvrRefrVersion);
|
|
|
|
HRESULT AddEnumToRefresher(
|
|
[in] WBEM_REFRESHER_ID* pRefresherId,
|
|
[in, string] LPCWSTR wszClass,
|
|
[in] long lFlags,
|
|
[in] IWbemContext* pContext,
|
|
[in] DWORD dwClientRefrVersion,
|
|
[out] WBEM_REFRESH_INFO* pInfo,
|
|
[out] DWORD* pdwSvrRefrVersion);
|
|
|
|
HRESULT RemoveObjectFromRefresher(
|
|
[in] WBEM_REFRESHER_ID* pRefresherId,
|
|
[in] long lId,
|
|
[in] long lFlags,
|
|
[in] DWORD dwClientRefrVersion,
|
|
[out] DWORD* pdwSvrRefrVersion);
|
|
|
|
HRESULT GetRemoteRefresher( [in] WBEM_REFRESHER_ID* pRefresherId,
|
|
[in] long lFlags,
|
|
[in] DWORD dwClientRefrVersion,
|
|
[out] IWbemRemoteRefresher** ppRemRefresher,
|
|
[out] GUID* pGuid,
|
|
[out] DWORD* pdwSvrRefrVersion);
|
|
|
|
HRESULT ReconnectRemoteRefresher(
|
|
[in] WBEM_REFRESHER_ID* pRefresherId,
|
|
[in] long lFlags,
|
|
[in] long lNumObjects,
|
|
[in] DWORD dwClientRefrVersion,
|
|
[in, size_is(lNumObjects)] WBEM_RECONNECT_INFO* apReconnectInfo,
|
|
[in, out, size_is(lNumObjects)] WBEM_RECONNECT_RESULTS* apReconnectResults ,
|
|
[out] DWORD* pdwSvrRefrVersion);
|
|
};
|
|
|
|
[restricted, local, uuid(504e6fe4-dfcd-11d1-adb4-00c04fd8fdff)]
|
|
interface IWbemUnloadingControl : IUnknown
|
|
{
|
|
HRESULT SetMustPreventUnloading([in] boolean bPrevent);
|
|
};
|
|
|
|
[restricted, local, uuid(61d629e4-e546-11d2-b33a-00105a1f4aaf)]
|
|
interface IWbemInternalServices : IUnknown
|
|
{
|
|
HRESULT FindKeyRoot(
|
|
[in, string] LPCWSTR wszClassName,
|
|
[out] IWbemClassObject** ppKeyRootClass);
|
|
|
|
HRESULT InternalGetClass(
|
|
[in, string] LPCWSTR wszClassName,
|
|
[out] IWbemClassObject** ppClass);
|
|
|
|
HRESULT InternalGetInstance(
|
|
[in, string] LPCWSTR wszPath,
|
|
[out] IWbemClassObject** ppInstance);
|
|
|
|
HRESULT InternalExecQuery(
|
|
[in, string] LPCWSTR wszQueryLanguage,
|
|
[in, string] LPCWSTR wszQuery,
|
|
[in] long lFlags,
|
|
[in] IWbemObjectSink* pSink);
|
|
|
|
HRESULT InternalCreateInstanceEnum(
|
|
[in, string] LPCWSTR wszClassName,
|
|
[in] long lFlags,
|
|
[in] IWbemObjectSink* pSink);
|
|
HRESULT GetDbInstance(
|
|
[in, string] LPCWSTR wszDbKey,
|
|
[out] IWbemClassObject** ppInstance);
|
|
HRESULT GetDbReferences(
|
|
[in] IWbemClassObject* pEndpoint,
|
|
[in] IWbemObjectSink* pSink);
|
|
HRESULT InternalPutInstance(
|
|
[in] IWbemClassObject* pInstance);
|
|
};
|
|
|
|
//
|
|
// IWbemObjectInternals
|
|
//
|
|
// Allows access to internal elements of the BLOB backing
|
|
// a WBEM object.
|
|
//
|
|
// It's main intent is to allow us to break apart and/or
|
|
// disable components while marshalling/unmarshalling and
|
|
// then repackage said components at a later point in time.
|
|
//
|
|
|
|
typedef enum tagWBEM_OBJINTERNALPARTS_INFO
|
|
{
|
|
WBEM_OBJ_DECORATION_PART = 0x1,
|
|
WBEM_OBJ_INSTANCE_PART = 0x2,
|
|
WBEM_OBJ_CLASS_PART = 0x4,
|
|
WBEM_OBJ_CLASS_PART_INTERNAL = 0x8,
|
|
WBEM_OBJ_CLASS_PART_SHARED = 0x10
|
|
} WBEM_OBJINTERNALPARTS_INFO;
|
|
|
|
[local, restricted, object, uuid(7A7EC9AE-11D6-11d2-B5F9-00104B703EFD)]
|
|
interface IWbemObjectInternals : IUnknown
|
|
{
|
|
HRESULT QueryObjectInfo(
|
|
[out] DWORD *pdwResult
|
|
);
|
|
|
|
HRESULT SetObjectMemory(
|
|
[in] LPVOID pMem,
|
|
[in] DWORD dwMemSize
|
|
);
|
|
|
|
HRESULT GetObjectMemory(
|
|
[out] LPVOID pDestination,
|
|
[in] DWORD dwDestBufSize,
|
|
[out] DWORD *pdwUsed
|
|
);
|
|
|
|
HRESULT SetObjectParts(
|
|
[in] LPVOID pMem,
|
|
[in] DWORD dwDestBufSize,
|
|
[in] DWORD dwParts
|
|
);
|
|
|
|
HRESULT GetObjectParts(
|
|
[out] LPVOID pDestination,
|
|
[in] DWORD dwDestBufSize,
|
|
[in] DWORD dwParts,
|
|
[out] DWORD *pdwUsed
|
|
);
|
|
|
|
HRESULT StripClassPart();
|
|
|
|
HRESULT SetClassPart(
|
|
[in] LPVOID pClassPart,
|
|
[in] DWORD dwSize
|
|
);
|
|
|
|
HRESULT MergeClassPart(
|
|
[in] IWbemClassObject *pClassPart
|
|
);
|
|
|
|
HRESULT IsObjectInstance();
|
|
|
|
HRESULT SetDecoration(
|
|
[in, string] LPCWSTR pwcsServer,
|
|
[in, string] LPCWSTR pwcsNamespace
|
|
);
|
|
|
|
HRESULT RemoveDecoration();
|
|
|
|
HRESULT CompareClassParts(
|
|
[in] IWbemClassObject* pObj,
|
|
[in] long lFlags
|
|
);
|
|
|
|
HRESULT ClearWriteOnlyProperties();
|
|
|
|
};
|
|
|
|
//
|
|
// IWbemWCOSmartEnum
|
|
//
|
|
// This Interface is intended to provide alternate synchronous enumeration of
|
|
// objects for IEnumWbemClassObject. If this is called, it calls the normal
|
|
// ::Next function, then repackages the data into a BYTE array which must
|
|
// be appropriateky unmarshaled on the receiving end.
|
|
//
|
|
//
|
|
|
|
[restricted, object, uuid(423EC01E-2E35-11d2-B604-00104B703EFD)]
|
|
interface IWbemWCOSmartEnum : IUnknown
|
|
{
|
|
HRESULT Next(
|
|
[in] REFGUID proxyGUID,
|
|
[in] LONG lTimeout,
|
|
[in] ULONG uCount,
|
|
[out] ULONG* puReturned,
|
|
[out] ULONG* pdwBuffSize,
|
|
[out, size_is(,*pdwBuffSize)] byte** pBuffer
|
|
);
|
|
};
|
|
|
|
//
|
|
// IWbemFetchSmartEnum
|
|
//
|
|
// This Interface is used to return a smart enumerator. It assists
|
|
// us when we need to get an enumerator but want to do so without
|
|
// causing AddRef problem with the Proxy Manager.
|
|
//
|
|
|
|
[restricted, object, uuid(1C1C45EE-4395-11d2-B60B-00104B703EFD)]
|
|
interface IWbemFetchSmartEnum : IUnknown
|
|
{
|
|
HRESULT GetSmartEnum(
|
|
[out] IWbemWCOSmartEnum** ppSmartEnum
|
|
);
|
|
};
|
|
|
|
//
|
|
// IWbemLoginHelper
|
|
//
|
|
// This Interface is used to verify if a connection is on the same
|
|
// machine.
|
|
//
|
|
|
|
[restricted, object, uuid(541679AB-2E5F-11d3-B34E-00104BCC4B4A)]
|
|
interface IWbemLoginHelper : IUnknown
|
|
{
|
|
HRESULT SetEvent([in] LPCSTR sEventToSet);
|
|
};
|
|
|
|
//
|
|
// ICreateSecondaryStub
|
|
//
|
|
// This Interface by unsecapp and winmgmt
|
|
//
|
|
|
|
[restricted, object, uuid(6468FE15-412D-11d3-B350-00104BCC4B4A)]
|
|
interface IWbemCreateSecondaryStub : IUnknown
|
|
{
|
|
HRESULT CreateSecondaryStub([out] IUnknown** ppSecondaryStub);
|
|
};
|
|
|
|
//
|
|
// IWinmgmtMofCompiler
|
|
//
|
|
//
|
|
//
|
|
|
|
[local, object, uuid(C10B4772-4DA0-11d2-A2F5-00C04F86FB7D)]
|
|
interface IWinmgmtMofCompiler : IUnknown
|
|
{
|
|
HRESULT WinmgmtCompileFile(
|
|
[in, string] LPWSTR FileName,
|
|
[in, string] LPWSTR ServerAndNamespace,
|
|
[in] LONG lOptionFlags, // autocomp, check, etc
|
|
[in] LONG lClassFlags,
|
|
[in] LONG lInstanceFlags,
|
|
[in] IWbemServices * pOverride,
|
|
[in] IWbemContext * pCtx,
|
|
[in, out] WBEM_COMPILE_STATUS_INFO * pInfo
|
|
);
|
|
// lFlags correspond to all the available command-line flags.
|
|
|
|
HRESULT WinmgmtCompileBuffer(
|
|
[in] long BuffSize,
|
|
[in, size_is(BuffSize)]BYTE * pBuffer,
|
|
[in] LONG lOptionFlags, // autocomp, check, etc
|
|
[in] LONG lClassFlags,
|
|
[in] LONG lInstanceFlags,
|
|
[in] IWbemServices * pOverride,
|
|
[in] IWbemContext * pCtx,
|
|
[in, out] WBEM_COMPILE_STATUS_INFO * pInfo
|
|
);
|
|
|
|
// lFlags correspond to all the available command-line flags.
|
|
};
|
|
|
|
/*
|
|
|
|
Client programming notes:
|
|
|
|
(1) Client takes IWbemServices, and does QI to get IWbemPerfDataServices
|
|
|
|
(2) Client retrieves objects through normal means, and can QI any IWbemClassObject
|
|
to get IWbemClassObjectEx.
|
|
|
|
(3) IWbemClassObjectEx will support scalar types VT_I4, VT_UI4, VT_I8, VT_UI8, VT_LPWSTR
|
|
|
|
(4) To get continuous data, client must call IWbemPerfDataServices::GetRefresherByObject
|
|
or IWbemPerfDataServices::GetRefreshByPath.
|
|
|
|
(5) Client executes IWbemRefresher::Refresh() and then the associated object is updated.
|
|
The object can again be retrieved through IWbemRefresher::GetObject. However, the
|
|
pointer could simply have been maintained throughout.
|
|
|
|
(6) After a GetObject() or Refresh(), the object maintains its state, and can be
|
|
alternately accessed via IWbemClassObject or IWbemClassObjectEx.
|
|
|
|
How does the client proxy know whether to carry out the refresh through the shared
|
|
memory, local refresh, or remote?
|
|
Answer: When GetRefresherByObject/...ByPath is called, a search is made for the object
|
|
in CIMOM. If an in-proc provider is supported it will be transparently loaded
|
|
into
|
|
|
|
Provider programming notes:
|
|
|
|
(1) Provider's class is in the repository.
|
|
(2) Provider implements IWbemTimeCriticalProvider. The namespace is understood
|
|
by the registration & CLSID.
|
|
(3) QueryInstances() returns the instances to the provided sink.
|
|
(4) CreateObjectRefresher() returns a refresher for a given instance.
|
|
The incoming object is for reference purposes.
|
|
The provider takes the incoming object or an equivalent one and
|
|
calls MapObject(). The mapped object is gauranteed to be in shared
|
|
memory.
|
|
(5) Provider implements IWbemRefresher. When Refresh() is called
|
|
the provider calls Lock() and updates the local copy mapped to
|
|
the blob, followed by Unlock().
|
|
|
|
[a] Provider can be CIMOM hosted, client-hosted, self-hosted, or remote-hosted.
|
|
|
|
|
|
Continuous provider:
|
|
(1) Becomes a general purpose provider, hosted by CIMOM.
|
|
(2) Provider calls GetObject on class def, and creates the necessary
|
|
instances.
|
|
(3) Each instance is mapped using MapObject().
|
|
(4) Properties are directly updated as required.
|
|
(5) Provider can release any pointers held to CIMOM. However,
|
|
if the provider is in-proc to CIMOM, this could result in
|
|
the provider getting itself unloaded. Only out-of-proc
|
|
providers need to worry about this.
|
|
|
|
(6) Provider calls Lock() and updates the properties, followed
|
|
by Unlock().
|
|
|
|
(7) When client executes Refresh(), which calls Lock(), does a blob
|
|
copy and then an Unlock().
|
|
|
|
|
|
|
|
|
|
|
|
problems: Provider needs an IWbemServices pointer to get class definitions.
|
|
|
|
|
|
|
|
*/
|
|
[uuid(027947f3-d731-11ce-a357-000000000001)]
|
|
library WbemInternal_v1
|
|
{
|
|
importlib("stdole32.tlb");
|
|
|
|
typedef enum tag_WBEM_MISC_FLAG_TYPE
|
|
{
|
|
WBEM_FLAG_KEEP_SHAPE = 0x100000,
|
|
WBEM_FLAG_NO_CLASS_PROVIDERS = 0x8000,
|
|
WBEM_FLAG_NO_EVENTS = 0x4000,
|
|
WBEM_FLAG_IGNORE_IDS = 0x2000,
|
|
WBEM_FLAG_IS_INOUT = 0x1000,
|
|
} WBEM_MISC_FLAG_TYPE;
|
|
|
|
typedef enum tag_WBEM_CLASSPART_FLAG_TYPE
|
|
{
|
|
WBEM_FLAG_CLASSPART_NOT_LOCALIZED = 0x00,
|
|
WBEM_FLAG_CLASSPART_LOCALIZED = 0x01,
|
|
WBEM_FLAG_CLASSPART_LOCALIZATION_MASK = 0x01
|
|
} WBEM_CLASSPART_FLAG_TYPE;
|
|
|
|
typedef enum tag_WBEM_INSTANCEPART_FLAG_TYPE
|
|
{
|
|
WBEM_FLAG_INSTANCEPART_NOT_LOCALIZED = 0x00,
|
|
WBEM_FLAG_INSTANCEPART_LOCALIZED = 0x01,
|
|
WBEM_FLAG_INSTANCEPART_LOCALIZATION_MASK = 0x01
|
|
} WBEM_INSTANCEPART_FLAG_TYPE;
|
|
|
|
typedef enum tag_WBEM_CMPCLSPART_FLAG_TYPE
|
|
{
|
|
WBEM_FLAG_COMPARE_FULL = 0x00,
|
|
WBEM_FLAG_COMPARE_BINARY = 0x01,
|
|
WBEM_FLAG_COMPARE_LOCALIZED = 0x02
|
|
} WBEM_CMPCLSPART_FLAG_TYPE;
|
|
|
|
interface IWbemPropertySource;
|
|
interface IWbemRawObjectSink;
|
|
interface IWbemDecorator;
|
|
interface IWbemEventSubsystem_m4;
|
|
interface IWbemCausalityAccess;
|
|
interface IWbemRefreshingServices;
|
|
interface IWbemRemoteRefresher;
|
|
interface IWbemMetaData;
|
|
interface IWbemFilterStub;
|
|
interface IWbemFilterProxy;
|
|
interface IWbemLifeControl;
|
|
interface IWbemCreateSecondaryStub;
|
|
|
|
/////////////////////////////////////////////////////////
|
|
//
|
|
// Marshaling proxy for WbemClassObjec
|
|
//
|
|
|
|
[restricted, uuid(4590f812-1d3a-11d0-891f-00aa004b2e24)]
|
|
coclass WbemClassObjectProxy
|
|
{
|
|
interface IWbemClassObject;
|
|
interface IMarshal;
|
|
};
|
|
|
|
[restricted, uuid(5d08b586-343a-11d0-ad46-00c04fd8fdff)]
|
|
coclass WbemEventSubsystem
|
|
{
|
|
interface IWbemEventSubsystem_m4;
|
|
};
|
|
|
|
[restricted, uuid(08a59b5d-dd50-11d0-ad6b-00c04fd8fdff)]
|
|
coclass HmmpEventConsumerProvider
|
|
{
|
|
interface IWbemUnboundObjectSink;
|
|
};
|
|
|
|
[restricted, uuid(6c19be35-7500-11d1-ad94-00c04fd8fdff)]
|
|
coclass WbemFilterProxy
|
|
{
|
|
interface IWbemFilterProxy;
|
|
interface IWbemObjectSink;
|
|
};
|
|
|
|
[restricted, uuid(4fa18276-912a-11d1-ad9b-00c04fd8fdff)]
|
|
coclass InProcWbemLevel1Login
|
|
{
|
|
interface IWbemLevel1Login;
|
|
};
|
|
|
|
[uuid(C10B4771-4DA0-11d2-A2F5-00C04F86FB7D)]
|
|
coclass WinmgmtMofCompiler
|
|
{
|
|
interface IWinmgmtMofCompiler;
|
|
};
|
|
};
|