Source code of Windows XP (NT5)
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.
 
 
 
 
 
 

625 lines
18 KiB

[uuid(226c9290-dd96-11d3-a120-00105a1f515a)]
library WbemUtilities_v1
{
importlib("stdole32.tlb");
typedef [v1_enum] enum tag_WBEM_PATH_STATUS_FLAG
{
WBEMPATH_INFO_ANON_LOCAL_MACHINE = 0x1, // <path has \\. as server name>
WBEMPATH_INFO_HAS_MACHINE_NAME = 0x2, // <not a dot>
WBEMPATH_INFO_IS_CLASS_REF = 0x4, // <a path to a classs, not a path to an instance>
WBEMPATH_INFO_IS_INST_REF = 0x8, // <a path to an instance>
WBEMPATH_INFO_HAS_SUBSCOPES = 0x10, // <true if a subscope is present>
WBEMPATH_INFO_IS_COMPOUND = 0x20, // <true if compound key is used>
WBEMPATH_INFO_HAS_V2_REF_PATHS = 0x40, // <true if V2-style ref paths are used>
WBEMPATH_INFO_HAS_IMPLIED_KEY = 0x80, // <true if keynames are missing somewhere>
WBEMPATH_INFO_CONTAINS_SINGLETON = 0x100, // <true if one or more singletons>
WBEMPATH_INFO_V1_COMPLIANT = 0x200, // <true if path is WBEM-V1-compliant>
WBEMPATH_INFO_V2_COMPLIANT = 0x400, // <true if path is WBEM-V2-compliant>
WBEMPATH_INFO_CIM_COMPLIANT = 0x800, // <true if path is CIM-compliant>
WBEMPATH_INFO_IS_SINGLETON = 0x1000, // <a path to a singleton>
WBEMPATH_INFO_IS_PARENT = 0x2000, // <path is just "..">
WBEMPATH_INFO_SERVER_NAMESPACE_ONLY = 0x4000, // <path is just "..">
} tag_WBEM_PATH_STATUS_FLAG;
typedef [v1_enum] enum tag_WBEM_PATH_CREATE_FLAG
{
WBEMPATH_CREATE_ACCEPT_RELATIVE = 0x1,
WBEMPATH_CREATE_ACCEPT_ABSOLUTE = 0x2,
WBEMPATH_CREATE_ACCEPT_ALL = 0x4,
WBEMPATH_TREAT_SINGLE_IDENT_AS_NS = 0x8,
} tag_WBEM_PATH_CREATE_FLAG;
typedef [v1_enum] enum tag_WBEM_GET_TEXT_FLAGS
{
WBEMPATH_COMPRESSED = 0x1,
WBEMPATH_GET_RELATIVE_ONLY = 0X2,
WBEMPATH_GET_SERVER_TOO = 0X4,
WBEMPATH_GET_SERVER_AND_NAMESPACE_ONLY = 0X8,
} tag_WBEM_GET_TEXT_FLAGS;
typedef [v1_enum] enum tag_WBEM_GET_KEY_FLAGS
{
WBEMPATH_TEXT = 0x1,
WBEMPATH_QUOTEDTEXT = 0X2
} tag_WBEM_GET_KEY_FLAGS;
//*******************************************************************
// NOT CoCreatable; get this from IWbemPath
[local, object, uuid(9AE62877-7544-4bb0-AA26-A13824659ED6)]
interface IWbemPathKeyList : IUnknown
{
HRESULT GetCount(
[out] ULONG * puKeyCount
);
HRESULT SetKey(
[in, string] LPCWSTR wszName,
[in] ULONG uFlags, // Add flag for SINGLETON
[in] ULONG uCimType, // Implies the size
[in] LPVOID pKeyVal
);
HRESULT SetKey2(
[in, string] LPCWSTR wszName,
[in] ULONG uFlags, // Add flag for SINGLETON
[in] ULONG uCimType,
[in] VARIANT * pKeyVal
);
HRESULT GetKey(
[in] ULONG uKeyIx,
[in] ULONG uFlags, // Add flag for SINGLETON
[in,out] ULONG * puNameBufSize, // In bytes; must be large enough for UNICODE null
[in,out] LPWSTR pszKeyName, // May be NULL for implicit keys
[in,out] ULONG * puKeyValBufSize, // In Bytes, includes double NULL
[in,out] LPVOID pKeyVal, // Key Val
[out] ULONG *puApparentCimType // One of CIM_SINT32, CIM_SINT64, CIM_STRING, etc.
);
HRESULT GetKey2(
[in] ULONG uKeyIx,
[in] ULONG uFlags, // Add flag for SINGLETON
[in,out] ULONG * puNameBufSize, // In bytes; must be large enough for UNICODE null
[in,out] LPWSTR pszKeyName, // May be NULL for implicit keys
[in,out] VARIANT * pKeyValue, // In Bytes, includes double NULL
[out] ULONG *puApparentCimType // One of CIM_SINT32, CIM_SINT64, CIM_STRING, etc.
);
HRESULT RemoveKey(
[in, string] LPCWSTR wszName,
[in] ULONG uFlags
);
HRESULT RemoveAllKeys(
[in] ULONG uFlags
);
HRESULT MakeSingleton([in] boolean bSet);
// WBEMPATH_INFO_IS_COMPOUND <true if compound key is used
// WBEMPATH_INFO_HAS_V2_REF_PATHS <true if V2-style ref paths are used
// WBEMPATH_INFO_HAS_IMPLIED_KEY <true if keynames are missing somewhere
// WBEMPATH_INFO_CONTAINS_SINGLETON <true if one or more singletons
HRESULT GetInfo(
[in] ULONG uRequestedInfo,
[out] ULONGLONG *puResponse
);
HRESULT GetText(
[in] long lFlags, // tag_WBEM_GET_KEY_FLAGS
[in,out] ULONG * puBuffLength,
[in, out, string] LPWSTR pszText
);
};
//*******************************************************************
// CoCreatable
[local, object, uuid(3BC15AF2-736C-477e-9E51-238AF8667DCC)]
interface IWbemPath : IUnknown
{
HRESULT SetText(
[in] ULONG uMode, // see tag_WBEM_PATH_CREATE_FLAG
[in] LPCWSTR pszPath
);
HRESULT GetText(
[in] long lFlags, // see tag_WBEM_GET_TEXT_FLAGS
[in,out] ULONG * puBuffLength,
[in, out, string] LPWSTR pszText
);
// Path tests
// ==========
HRESULT GetInfo(
[in] ULONG uRequestedInfo, // zero for now
[out] ULONGLONG *puResponse // see tag_WBEM_PATH_STATUS_FLAG
);
// Server access
// =============
HRESULT SetServer(
[in, string] LPCWSTR Name
);
HRESULT GetServer(
[in,out] ULONG * puNameBufLength,
[in, out, string] LPWSTR pName
);
// Namespace access. Example, root\default, root is 0, 1 is def
// =============================================================
HRESULT GetNamespaceCount(
[out] ULONG* puCount
);
HRESULT SetNamespaceAt(
[in] ULONG uIndex,
[in, string] LPCWSTR pszName
);
HRESULT GetNamespaceAt(
[in] ULONG uIndex,
[in,out] ULONG * puNameBufLength,
[in, out, string] LPWSTR pName
);
HRESULT RemoveNamespaceAt(
[in] ULONG uIndex
);
HRESULT RemoveAllNamespaces(
);
//
// Scope manipulators. The leftmost scope is 0
// ============================================
HRESULT GetScopeCount(
[out] ULONG *puCount
);
HRESULT SetScope(
[in] ULONG uIndex,
[in] LPWSTR pszClass
);
HRESULT SetScopeFromText(
[in] ULONG uIndex,
[in] LPWSTR pszText
);
HRESULT GetScope(
[in] ULONG uIndex,
[in,out] ULONG * puClassNameBufSize,
[in,out] LPWSTR pszClass,
[out] IWbemPathKeyList **pKeyList
);
HRESULT GetScopeAsText(
[in] ULONG uIndex,
[in,out] ULONG * puTextBufSize,
[in,out] LPWSTR pszText
);
HRESULT RemoveScope(
[in] ULONG uIndex
);
HRESULT RemoveAllScopes(
);
// General class and key access routines
// =====================================
HRESULT SetClassName(
[in, string] LPCWSTR Name
);
HRESULT GetClassName(
[in,out] ULONG * puBuffLength,
[in, out, string] LPWSTR pszName
);
HRESULT GetKeyList(
[out] IWbemPathKeyList ** pOut
);
HRESULT CreateClassPart(
[in] long lFlags,
[in, string] LPCWSTR Name
);
HRESULT DeleteClassPart(
[in] long lFlags
);
};
//***********************************************************************
//
[restricted, uuid(cf4cc405-e2c5-4ddd-b3ce-5e7582d8c9fa)]
coclass WbemDefPath
{
interface IWbemPath;
};
interface IWbemQuery;
[uuid(EAC8A024-21E2-4523-AD73-A71A0AA2F56A)]
coclass WbemQuery
{
interface IWbemQuery;
};
};
//*******************************************************************
// Query parser & analysis interfaces
typedef enum
{
WMIQ_ANALYSIS_RPN_SEQUENCE = 0x1,
WMIQ_ANALYSIS_ASSOC_QUERY = 0x2,
WMIQ_ANALYSIS_PROP_ANALYSIS_MATRIX = 0x3
} WMIQ_ANALYSIS_TYPE;
typedef enum
{
// Group 1
// Returned by GetNodeType
WMIQ_RPN_TOKEN_EXPRESSION = 1,
WMIQ_RPN_TOKEN_AND = 2,
WMIQ_RPN_TOKEN_OR = 3,
WMIQ_RPN_TOKEN_NOT = 4,
// Group 2
WMIQ_RPN_OP_EQ = 1,
WMIQ_RPN_OP_NE = 2,
WMIQ_RPN_OP_EQGT = 3,
WMIQ_RPN_OP_EQLT = 4,
WMIQ_RPN_OP_LT = 5,
WMIQ_RPN_OP_GT = 6,
WMIQ_RPN_OP_LIKE = 7,
WMIQ_RPN_OP_ISA = 8,
WMIQ_RPN_OP_ISNOTA = 9,
// Group 3
WMIQ_RPN_LEFT_PROPERTY_NAME = 0x1,
WMIQ_RPN_RIGHT_PROPERTY_NAME = 0x2,
WMIQ_RPN_LEFT_CONST = 0x4,
WMIQ_RPN_RIGHT_CONST = 0x8,
WMIQ_RPN_RELOP = 0x10,
WMIQ_RPN_LEFT_FUNCTION = 0x20,
WMIQ_RPN_RIGHT_FUNCTION = 0x30,
// Group 4
WMIQ_RPN_GET_TOKEN_TYPE = 1, // Returns Group 1 ULONG value
WMIQ_RPN_GET_EXPR_SHAPE = 2, // Returns Group 3 ULONG mask
WMIQ_RPN_GET_LEFT_FUNCTION = 3, // Returns LPWSTR
WMIQ_RPN_GET_RIGHT_FUNCTION = 4, // Returns LPWSTR
WMIQ_RPN_GET_RELOP = 5, // Returns a Group 2 ULONG
// Group 5
WMIQ_RPN_NEXT_TOKEN = 1
} WMIQ_RPN_TOKEN_FLAGS;
typedef enum
{
WMIQ_ASSOCQ_ASSOCIATORS = 0x1,
WMIQ_ASSOCQ_REFERENCES = 0x2,
WMIQ_ASSOCQ_RESULTCLASS = 0x4,
WMIQ_ASSOCQ_ROLE = 0x8,
WMIQ_ASSOCQ_RESULTROLE = 0x10,
WMIQ_ASSOCQ_REQUIREDQUALIFIER = 0x20,
WMIQ_ASSOCQ_REQUIREDASSOCQUALIFIER = 0x40,
WMIQ_ASSOCQ_CLASSDEFSONLY = 0x80,
WMIQ_ASSOCQ_KEYSONLY = 0x100,
WMIQ_ASSOCQ_SCHEMAONLY = 0x200,
WMIQ_ASSOCQ_CLASSREFSONLY = 0x400
} WMIQ_ASSOCQ_FLAGS;
// **********************************************************************
//
typedef struct tag_SWmiQueryQualifiedName
{
ULONG m_uVersion;
ULONG m_uTokenType;
ULONG m_uNameCount;
LPCWSTR *m_pszNameList;
BOOL m_bArraysUsed;
BOOL *m_bArrayUsed;
ULONG *m_uArrayIndex;
} SWmiQueryQualifiedName;
// **********************************************************************
// RPN token for normal queries
typedef struct tag_SWbemRpnQueryToken
{
ULONG m_uVersion;
ULONG m_uTokenType;
ULONG m_uSubexpressionShape;
ULONG m_uOperator;
SWmiQueryQualifiedName *m_pRightIdent;
SWmiQueryQualifiedName *m_pLeftIdent;
ULONG m_uRightConstApparentType; // CIM_ type
LPVOID m_pRightConst;
LPVOID m_pLeftConst;
ULONG m_uLeftConstApparentType; // CIM_ type
LPCWSTR pszLeftFunc;
LPCWSTR pszRightFunc;
} SWbemRpnQueryToken;
typedef struct tag_SWbemRpnTokenList
{
ULONG m_uVersion;
ULONG m_uTokenType;
ULONG m_uNumTokens;
SWbemRpnQueryToken *m_pTokens;
} SWbemRpnTokenList;
typedef enum tag_WMIQ_LANGUAGE_FEATURES
{
// The LF1 corresponds to the integer value. Do not alter!
WMIQ_LF1_BASIC_SELECT = 1, // *
WMIQ_LF2_CLASS_NAME_IN_QUERY = 2, // *
WMIQ_LF3_STRING_CASE_FUNCTIONS = 3, // *
WMIQ_LF4_PROP_TO_PROP_TESTS = 4, // *
WMIQ_LF5_COUNT_STAR = 5,
WMIQ_LF6_ORDER_BY = 6, // *
WMIQ_LF7_DISTINCT = 7,
WMIQ_LF8_ISA = 8, // *
WMIQ_LF9_THIS = 9, // *
WMIQ_LF10_COMPEX_SUBEXPRESSIONS = 10,
WMIQ_LF11_ALIASING = 11,
WMIQ_LF12_GROUP_BY_HAVING = 12, // *
WMIQ_LF13_WMI_WITHIN = 13, // *
WMIQ_LF14_SQL_WRITE_OPERATIONS = 14,
WMIQ_LF15_GO = 15,
WMIQ_LF16_SINGLE_LEVEL_TRANSACTIONS = 16,
WMIQ_LF17_QUALIFIED_NAMES = 17, // *
WMIQ_LF18_ASSOCIATONS = 18, // *
WMIQ_LF19_SYSTEM_PROPERTIES = 19,
WMIQ_LF20_EXTENDED_SYSTEM_PROPERTIES = 20,
WMIQ_LF21_SQL89_JOINS = 21,
WMIQ_LF22_SQL92_JOINS = 22,
WMIQ_LF23_SUBSELECTS = 23,
WMIQ_LF24_UMI_EXTENSIONS = 24,
WMIQ_LF25_DATEPART = 25, // *
WMIQ_LF26_LIKE = 26, // *
WMIQ_LF27_CIM_TEMPORAL_CONSTRUCTS = 27, // *
WMIQ_LF28_STANDARD_AGGREGATES = 28,
WMIQ_LF29_MULTI_LEVEL_ORDER_BY = 29,
WMIQ_LF30_WMI_PRAGMAS = 30,
WMIQ_LF31_QUALIFIER_TESTS = 31,
WMIQ_LF32_SP_EXECUTE = 32,
WMIQ_LF33_ARRAY_ACCESS = 33, // *
WMIQ_LF34_UNION = 34,
WMIQ_LF35_COMPLEX_SELECT_TARGET = 35,
WMIQ_LF36_REFERENCE_TESTS = 36,
WMIQ_LF37_SELECT_INTO = 37,
WMIQ_LF38_BASIC_DATETIME_TESTS = 38,
WMIQ_LF_LAST = 39
} WMIQ_LANGUAGE_FEATURES;
typedef enum tag_WMIQ_RPNQ_FEATURE
{
WMIQ_RPNF_WHERE_CLAUSE_PRESENT = 0x1,
WMIQ_RPNF_QUERY_IS_CONJUNCTIVE = 0x2,
WMIQ_RPNF_QUERY_IS_DISJUNCTIVE = 0x4,
WMIQ_RPNF_PROJECTION = 0x8,
WMIQ_RPNF_FEATURE_SELECT_STAR = 0x10,
WMIQ_RPNF_EQUALITY_TESTS_ONLY = 0x20,
WMIQ_RPNF_COUNT_STAR = 0x40,
WMIQ_RPNF_QUALIFIED_NAMES_IN_SELECT = 0x80,
WMIQ_RPNF_QUALIFIED_NAMES_IN_WHERE = 0x100,
WMIQ_RPNF_PROP_TO_PROP_TESTS = 0x200,
WMIQ_RPNF_ORDER_BY = 0x400,
WMIQ_RPNF_ISA_USED = 0x800,
WMIQ_RPNF_ISNOTA_USED = 0x1000,
WMIQ_RPNF_GROUP_BY_HAVING = 0x2000,
WMIQ_RPNF_WITHIN_INTERVAL = 0x4000,
WMIQ_RPNF_WITHIN_AGGREGATE = 0x8000,
WMIQ_RPNF_SYSPROP_CLASS = 0x10000,
WMIQ_RPNF_REFERENCE_TESTS = 0x20000,
WMIQ_RPNF_DATETIME_TESTS = 0x40000,
WMIQ_RPNF_ARRAY_ACCESS = 0x80000,
WMIQ_RPNF_QUALIFIER_FILTER = 0x100000,
} WMIQ_RPNF_FEATURE;
typedef struct tag_SWbemRpnEncodedQuery
{
ULONG m_uVersion;
ULONG m_uTokenType;
// General query features
ULONGLONG m_uParsedFeatureMask; // 64-bit WMIQ_RPNF_ mask
// Overall language features encountered
ULONG m_uDetectedArraySize;
ULONG *m_puDetectedFeatures; // Array of LFn_ constants
// Values being selected if WMIQ_RPNF_PROJECTION is set
ULONG m_uSelectListLength;
SWmiQueryQualifiedName **m_pSelectList;
// Class being selected from
ULONG m_uSelectTargetType;
LPCWSTR m_pszSelectTarget;
// Where clause
SWbemRpnTokenList *m_pRpnWhereClause;
// WITHIN value
double m_dblWithinValue;
// ORDER BY
ULONG m_uOrderByListLength;
LPCWSTR *m_pszOrderByList;
} SWbemRpnEncodedQuery;
// **********************************************************************
typedef struct tag_SWbemAnalysisMatrix
{
ULONG m_uVersion;
ULONG m_uMatrixType;
LPCWSTR m_pszProperty;
ULONG m_uPropertyType;
ULONG m_uEntries;
LPVOID *m_pValues;
BOOL *m_pbTruthTable;
} SWbemAnalysisMatrix;
typedef struct tag_SWbemAnalysisMatrixList
{
ULONG m_uVersion;
ULONG m_uMatrixType;
ULONG m_uNumMatrices;
SWbemAnalysisMatrix *m_pMatrices;
} SWbemAnalysisMatrixList;
// **********************************************************************
// Associators/ References queries
typedef struct tag_SWbemAssocQueryInf
{
ULONG m_uVersion;
ULONG m_uAnalysisType;
ULONG m_uFeatureMask;
IWbemPath *m_pPath;
LPWSTR m_pszPath;
LPWSTR m_pszQueryText;
LPWSTR m_pszResultClass;
LPWSTR m_pszAssocClass;
LPWSTR m_pszRole;
LPWSTR m_pszResultRole;
LPWSTR m_pszRequiredQualifier;
LPWSTR m_pszRequiredAssocQualifier;
} SWbemAssocQueryInf;
[local, object, uuid(81166f58-dd98-11d3-a120-00105a1f515a)]
interface IWbemQuery : IUnknown
{
HRESULT Empty();
HRESULT SetLanguageFeatures(
[in] long lFlags,
[in] ULONG uArraySize,
[in] ULONG *puFeatures
);
HRESULT TestLanguageFeatures(
[in,out] ULONG *uArraySize,
[out] ULONG *puFeatures
);
HRESULT Parse(
[in] LPCWSTR pszLang,
[in] LPCWSTR pszQuery,
[in] ULONG uFlags
);
HRESULT GetAnalysis(
[in] ULONG uAnalysisType,
[in] ULONG uFlags,
[out] LPVOID *pAnalysis
);
HRESULT FreeMemory(
[in] LPVOID pMem
);
HRESULT GetQueryInfo(
[in] ULONG uAnalysisType,
[in] ULONG uInfoId,
[in] ULONG uBufSize,
[out] LPVOID pDestBuf
);
HRESULT AttachClassDef(
[in] REFIID riid,
[in, iid_is(riid)] LPVOID pClassDef
);
HRESULT TestObject(
[in] ULONG uTestType,
[in] ULONG uFlags,
[in] REFIID riid,
[in, iid_is(riid)] LPVOID pObj
);
HRESULT StringTest(
[in] ULONG uTestType,
[in] LPCWSTR pszTestStr,
[in] LPCWSTR pszExpr
);
};