355 lines
9.1 KiB
Plaintext
355 lines
9.1 KiB
Plaintext
|
/*++
|
||
|
|
|
||
|
|
Copyright (C) 1996-2001 Microsoft Corporation
|
||
|
|
|
||
|
|
Module Name:
|
||
|
|
|
||
|
|
WBEMPROV.IDL
|
||
|
|
|
||
|
|
Abstract:
|
||
|
|
|
||
|
|
This IDL file defines the interfaces that WBEM providers need in addition
|
||
|
|
to the client interfaces defined in WBEMCLI.IDL
|
||
|
|
|
||
|
|
History:
|
||
|
|
|
||
|
|
--*/
|
||
|
|
|
||
|
|
import "objidl.idl";
|
||
|
|
import "oleidl.idl";
|
||
|
|
import "oaidl.idl";
|
||
|
|
import "wbemcli.idl";
|
||
|
|
|
||
|
|
|
||
|
|
typedef VARIANT WBEM_VARIANT;
|
||
|
|
typedef [string] WCHAR* WBEM_WSTR;
|
||
|
|
typedef [string] const WCHAR* WBEM_CWSTR;
|
||
|
|
|
||
|
|
typedef [v1_enum] enum tag_WBEM_PROVIDER_REQUIREMENTS_TYPE
|
||
|
|
{
|
||
|
|
WBEM_REQUIREMENTS_START_POSTFILTER = 0,
|
||
|
|
WBEM_REQUIREMENTS_STOP_POSTFILTER = 1,
|
||
|
|
WBEM_REQUIREMENTS_RECHECK_SUBSCRIPTIONS = 2
|
||
|
|
} WBEM_PROVIDER_REQUIREMENTS_TYPE;
|
||
|
|
|
||
|
|
[uuid(092df710-7010-11d1-ad90-00c04fd8fdff)]
|
||
|
|
library WbemProviders_v1
|
||
|
|
{
|
||
|
|
interface IWbemPropertyProvider;
|
||
|
|
interface IWbemUnboundObjectSink;
|
||
|
|
interface IWbemEventProvider;
|
||
|
|
interface IWbemEventProviderQuerySink;
|
||
|
|
interface IWbemEventProviderSecurity;
|
||
|
|
interface IWbemEventConsumerProvider;
|
||
|
|
interface IWbemEventConsumerProviderEx;
|
||
|
|
|
||
|
|
interface IWbemProviderInitSink;
|
||
|
|
interface IWbemProviderInit;
|
||
|
|
interface IWbemHiPerfProvider;
|
||
|
|
|
||
|
|
interface IWbemDecoupledRegistrar ;
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////
|
||
|
|
//
|
||
|
|
|
||
|
|
[uuid(cb8555cc-9128-11d1-ad9b-00c04fd8fdff)]
|
||
|
|
coclass WbemAdministrativeLocator
|
||
|
|
{
|
||
|
|
interface IWbemLocator;
|
||
|
|
};
|
||
|
|
|
||
|
|
// this assumes that the transport has verified that
|
||
|
|
// the user has access. Unlike the Administrative locator,
|
||
|
|
// it increases the count of external connections
|
||
|
|
|
||
|
|
[uuid(cd184336-9128-11d1-ad9b-00c04fd8fdff)]
|
||
|
|
coclass WbemAuthenticatedLocator
|
||
|
|
{
|
||
|
|
interface IWbemLocator;
|
||
|
|
};
|
||
|
|
|
||
|
|
// this is used by providers who dont know if a user
|
||
|
|
// has access or not.
|
||
|
|
|
||
|
|
[uuid(443E7B79-DE31-11d2-B340-00104BCC4B4A)]
|
||
|
|
coclass WbemUnauthenticatedLocator
|
||
|
|
{
|
||
|
|
interface IWbemLocator;
|
||
|
|
};
|
||
|
|
|
||
|
|
// this is used by providers that do not wish to be instantiated
|
||
|
|
// by winmgmt, rather the provider registers it's participation
|
||
|
|
// in servicing client requests as and when desired. This is
|
||
|
|
// primarily used by providers that act on the part of application
|
||
|
|
// hosts and that export management information only when they are activated
|
||
|
|
// via some application scenario.
|
||
|
|
|
||
|
|
[uuid(4cfc7932-0f9d-4bef-9c32-8ea2a6b56fcb)]
|
||
|
|
coclass WbemDecoupledRegistrar
|
||
|
|
{
|
||
|
|
interface IWbemDecoupledRegistrar ;
|
||
|
|
};
|
||
|
|
|
||
|
|
[uuid(f5f75737-2843-4f22-933d-c76a97cda62f)]
|
||
|
|
coclass WbemDecoupledBasicEventProvider
|
||
|
|
{
|
||
|
|
interface IWbemDecoupledBasicEventProvider ;
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
};
|
||
|
|
|
||
|
|
#define OPTIONAL in, unique
|
||
|
|
|
||
|
|
[restricted, object, uuid(e246107b-b06e-11d0-ad61-00c04fd8fdff)]
|
||
|
|
interface IWbemUnboundObjectSink : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT IndicateToConsumer(
|
||
|
|
[in] IWbemClassObject* pLogicalConsumer,
|
||
|
|
[in] long lNumObjects,
|
||
|
|
[in, size_is(lNumObjects)] IWbemClassObject** apObjects);
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////
|
||
|
|
//
|
||
|
|
//
|
||
|
|
|
||
|
|
[restricted, object, uuid(CE61E841-65BC-11d0-B6BD-00AA003240C7)]
|
||
|
|
|
||
|
|
interface IWbemPropertyProvider : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT GetProperty(
|
||
|
|
[in] long lFlags,
|
||
|
|
[in] const BSTR strLocale,
|
||
|
|
[in] const BSTR strClassMapping,
|
||
|
|
[in] const BSTR strInstMapping,
|
||
|
|
[in] const BSTR strPropMapping,
|
||
|
|
[out] VARIANT* pvValue
|
||
|
|
);
|
||
|
|
|
||
|
|
HRESULT PutProperty(
|
||
|
|
[in] long lFlags,
|
||
|
|
[in] const BSTR strLocale,
|
||
|
|
[in] const BSTR strClassMapping,
|
||
|
|
[in] const BSTR strInstMapping,
|
||
|
|
[in] const BSTR strPropMapping,
|
||
|
|
[in] const VARIANT* pvValue
|
||
|
|
);
|
||
|
|
};
|
||
|
|
|
||
|
|
[restricted, object, uuid(e245105b-b06e-11d0-ad61-00c04fd8fdff)]
|
||
|
|
interface IWbemEventProvider : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT ProvideEvents(
|
||
|
|
[in] IWbemObjectSink* pSink,
|
||
|
|
[in] long lFlags
|
||
|
|
);
|
||
|
|
};
|
||
|
|
|
||
|
|
[restricted, object, uuid(580acaf8-fa1c-11d0-ad72-00c04fd8fdff)]
|
||
|
|
interface IWbemEventProviderQuerySink : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT NewQuery(
|
||
|
|
[in] unsigned long dwId,
|
||
|
|
[in] WBEM_WSTR wszQueryLanguage,
|
||
|
|
[in] WBEM_WSTR wszQuery
|
||
|
|
);
|
||
|
|
HRESULT CancelQuery(
|
||
|
|
[in] unsigned long dwId);
|
||
|
|
};
|
||
|
|
|
||
|
|
[restricted, object, uuid(631f7d96-d993-11d2-b339-00105a1f4aaf)]
|
||
|
|
interface IWbemEventProviderSecurity : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT AccessCheck(
|
||
|
|
[in] WBEM_CWSTR wszQueryLanguage,
|
||
|
|
[in] WBEM_CWSTR wszQuery,
|
||
|
|
[in] long lSidLength,
|
||
|
|
[in, size_is(lSidLength), unique] const BYTE* pSid);
|
||
|
|
};
|
||
|
|
|
||
|
|
[restricted, object, uuid(631f7d97-d993-11d2-b339-00105a1f4aaf)]
|
||
|
|
interface IWbemProviderIdentity : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT SetRegistrationObject(
|
||
|
|
[in] long lFlags,
|
||
|
|
[in] IWbemClassObject* pProvReg);
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
[restricted, object, uuid(e246107a-b06e-11d0-ad61-00c04fd8fdff)]
|
||
|
|
interface IWbemEventConsumerProvider : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT FindConsumer(
|
||
|
|
[in] IWbemClassObject* pLogicalConsumer,
|
||
|
|
[out] IWbemUnboundObjectSink** ppConsumer);
|
||
|
|
};
|
||
|
|
|
||
|
|
[object, restricted, uuid(17cf534a-d8a3-4ad0-ac92-5e3d01717151)]
|
||
|
|
interface IWbemEventConsumerProviderEx : IWbemEventConsumerProvider
|
||
|
|
{
|
||
|
|
HRESULT ValidateSubscription(
|
||
|
|
[in] IWbemClassObject* pLogicalConsumer);
|
||
|
|
};
|
||
|
|
|
||
|
|
typedef enum tag_WBEM_EXTRA_RETURN_CODES
|
||
|
|
{
|
||
|
|
WBEM_S_INITIALIZED = 0,
|
||
|
|
WBEM_S_LIMITED_SERVICE = 0x43001,
|
||
|
|
WBEM_S_INDIRECTLY_UPDATED,
|
||
|
|
WBEM_S_SUBJECT_TO_SDS,
|
||
|
|
|
||
|
|
|
||
|
|
WBEM_E_RETRY_LATER = 0x80043001,
|
||
|
|
WBEM_E_RESOURCE_CONTENTION,
|
||
|
|
} WBEM_EXTRA_RETURN_CODES;
|
||
|
|
|
||
|
|
typedef enum tag_WBEM_PROVIDER_FLAGS
|
||
|
|
{
|
||
|
|
WBEM_FLAG_OWNER_UPDATE = 0x10000,
|
||
|
|
} WBEM_PROVIDER_FLAGS;
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
[object, uuid(1be41571-91dd-11d1-aeb2-00c04fb68820)]
|
||
|
|
|
||
|
|
interface IWbemProviderInitSink : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT SetStatus(
|
||
|
|
[in] LONG lStatus,
|
||
|
|
[in] LONG lFlags
|
||
|
|
);
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
[object, uuid(1be41572-91dd-11d1-aeb2-00c04fb68820)]
|
||
|
|
|
||
|
|
interface IWbemProviderInit : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT Initialize(
|
||
|
|
[in, unique, string] LPWSTR wszUser,
|
||
|
|
[in] LONG lFlags,
|
||
|
|
[in, string] LPWSTR wszNamespace,
|
||
|
|
[in, unique, string] LPWSTR wszLocale,
|
||
|
|
[in] IWbemServices* pNamespace,
|
||
|
|
[in] IWbemContext* pCtx,
|
||
|
|
[in] IWbemProviderInitSink* pInitSink
|
||
|
|
);
|
||
|
|
};
|
||
|
|
|
||
|
|
[local, restricted, object, uuid(49353c93-516b-11d1-aea6-00c04fb68820)]
|
||
|
|
interface IWbemHiPerfProvider : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT QueryInstances(
|
||
|
|
[in] IWbemServices* pNamespace,
|
||
|
|
[in, string] WCHAR* wszClass,
|
||
|
|
[in] long lFlags,
|
||
|
|
[in] IWbemContext* pCtx,
|
||
|
|
[in] IWbemObjectSink* pSink // Return IWbemClassObject ptrs
|
||
|
|
);
|
||
|
|
|
||
|
|
HRESULT CreateRefresher(
|
||
|
|
[in] IWbemServices* pNamespace,
|
||
|
|
[in] long lFlags,
|
||
|
|
[out] IWbemRefresher** ppRefresher);
|
||
|
|
|
||
|
|
HRESULT CreateRefreshableObject(
|
||
|
|
[in] IWbemServices* pNamespace,
|
||
|
|
[in] IWbemObjectAccess* pTemplate,
|
||
|
|
[in] IWbemRefresher* pRefresher,
|
||
|
|
[in] long lFlags,
|
||
|
|
[in] IWbemContext* pContext,
|
||
|
|
[out] IWbemObjectAccess** ppRefreshable,
|
||
|
|
[out] long* plId);
|
||
|
|
|
||
|
|
HRESULT StopRefreshing(
|
||
|
|
[in] IWbemRefresher* pRefresher,
|
||
|
|
[in] long lId,
|
||
|
|
[in] long lFlags);
|
||
|
|
|
||
|
|
HRESULT CreateRefreshableEnum(
|
||
|
|
[in] IWbemServices* pNamespace,
|
||
|
|
[in, string] LPCWSTR wszClass,
|
||
|
|
[in] IWbemRefresher* pRefresher,
|
||
|
|
[in] long lFlags,
|
||
|
|
[in] IWbemContext* pContext,
|
||
|
|
[in] IWbemHiPerfEnum* pHiPerfEnum,
|
||
|
|
[out] long* plId);
|
||
|
|
|
||
|
|
HRESULT GetObjects(
|
||
|
|
[in] IWbemServices* pNamespace,
|
||
|
|
[in] long lNumObjects,
|
||
|
|
[in,out,size_is(lNumObjects)] IWbemObjectAccess** apObj,
|
||
|
|
[in] long lFlags,
|
||
|
|
[in] IWbemContext* pContext);
|
||
|
|
|
||
|
|
};
|
||
|
|
|
||
|
|
[object, local, uuid(1005cbcf-e64f-4646-bcd3-3a089d8a84b4)]
|
||
|
|
interface IWbemDecoupledRegistrar : IUnknown
|
||
|
|
{
|
||
|
|
HRESULT Register (
|
||
|
|
|
||
|
|
[in] long a_Flags ,
|
||
|
|
[in] IWbemContext *a_Context ,
|
||
|
|
[in] LPCWSTR a_User ,
|
||
|
|
[in] LPCWSTR a_Locale ,
|
||
|
|
[in] LPCWSTR a_Scope ,
|
||
|
|
[in] LPCWSTR a_Registration ,
|
||
|
|
[in] IUnknown *a_Unknown
|
||
|
|
) ;
|
||
|
|
|
||
|
|
HRESULT UnRegister () ;
|
||
|
|
} ;
|
||
|
|
|
||
|
|
[object, local, uuid(86336d20-ca11-4786-9ef1-bc8a946b42fc)]
|
||
|
|
interface IWbemDecoupledBasicEventProvider : IWbemDecoupledRegistrar
|
||
|
|
{
|
||
|
|
HRESULT GetSink (
|
||
|
|
|
||
|
|
[in] long a_Flags ,
|
||
|
|
[in] IWbemContext *a_Context ,
|
||
|
|
[out] IWbemObjectSink **a_Sink
|
||
|
|
) ;
|
||
|
|
|
||
|
|
HRESULT GetService (
|
||
|
|
|
||
|
|
[in] long a_Flags ,
|
||
|
|
[in] IWbemContext *a_Context ,
|
||
|
|
[out] IWbemServices **a_Service
|
||
|
|
) ;
|
||
|
|
|
||
|
|
} ;
|
||
|
|
|
||
|
|
typedef [v1_enum] enum tag_WBEM_BATCH_TYPE
|
||
|
|
{
|
||
|
|
WBEM_FLAG_BATCH_IF_NEEDED = 0,
|
||
|
|
WBEM_FLAG_MUST_BATCH = 0x1,
|
||
|
|
WBEM_FLAG_MUST_NOT_BATCH = 0x2
|
||
|
|
} WBEM_BATCH_TYPE;
|
||
|
|
|
||
|
|
|
||
|
|
[object, restricted, uuid(3ae0080a-7e3a-4366-bf89-0feedc931659)]
|
||
|
|
interface IWbemEventSink : IWbemObjectSink
|
||
|
|
{
|
||
|
|
HRESULT SetSinkSecurity(
|
||
|
|
[in] long lSDLength,
|
||
|
|
[in, size_is(lSDLength)] BYTE* pSD);
|
||
|
|
|
||
|
|
HRESULT IsActive();
|
||
|
|
|
||
|
|
HRESULT GetRestrictedSink(
|
||
|
|
[in] long lNumQueries,
|
||
|
|
[in, size_is(lNumQueries), string] const LPCWSTR* awszQueries,
|
||
|
|
[in] IUnknown* pCallback,
|
||
|
|
[out] IWbemEventSink** ppSink);
|
||
|
|
|
||
|
|
HRESULT SetBatchingParameters(
|
||
|
|
[in] LONG lFlags,
|
||
|
|
[in] DWORD dwMaxBufferSize,
|
||
|
|
[in] DWORD dwMaxSendLatency);
|
||
|
|
};
|
||
|
|
|