[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 ); };