|
|
/*===================================================================
Microsoft Denali
Microsoft Confidential. Copyright 1997 Microsoft Corporation. All Rights Reserved.
Component: MetaUtil object
File: MetaSchm.cpp
Owner: t-BrianM
This file contains implementation of the CMetaSchemaTable object and other schema related objects.
The CMetaSchemaTable object has COM style reference counting so it can service objects created by CMetaUtil. I didn't make it a full blown COM object because all of the class stuff would be a pain to export.
To reduce the overhead of maintaining this object (which may or may not be used), all information is loaded on demand, then set dirty or unloaded when portions of the metabase associated with it are modified. ===================================================================*/
#include "stdafx.h"
#include "MetaUtil.h"
#include "MUtilObj.h"
#include "MetaSchm.h"
/*------------------------------------------------------------------
* C P r o p I n f o */
/*===================================================================
CPropInfo::Init
Constructor
Parameters: dwId Id of property
Returns: S_OK on success ===================================================================*/ HRESULT CPropInfo::Init(DWORD dwId) { m_dwId = dwId;
return S_OK; }
/*===================================================================
CPropInfo::SetName
Sets the property name.
Parameters: tszName Name of property
Returns: E_OUTOFMEMORY if allocation fails S_OK on success ===================================================================*/ HRESULT CPropInfo::SetName(LPCTSTR tszName) { ASSERT_STRING(tszName); ASSERT(m_tszName == NULL); // m_tszName not yet set
m_tszName = new TCHAR[_tcslen(tszName) + 1]; if (m_tszName == NULL) { return E_OUTOFMEMORY; } _tcscpy(m_tszName, tszName);
return S_OK; }
/*===================================================================
CPropInfo::SetTypeInfo
Sets the property name.
Parameters: pType PropValue structure containing type information.
Returns: E_OUTOFMEMORY if allocation fails S_OK on success ===================================================================*/ HRESULT CPropInfo::SetTypeInfo(PropValue *pType) { ASSERT_POINTER(pType, PropValue); ASSERT(m_pType == NULL); // m_pType not yet set
m_pType = new PropValue; if (m_pType == NULL) { return E_OUTOFMEMORY; } memcpy(m_pType, pType, sizeof(PropValue));
return S_OK; }
/*------------------------------------------------------------------
* C P r o p I n f o T a b l e */
/*===================================================================
CPropInfoTable::CPropInfoTable
Constructor
Parameters: None
Returns: Nothing ===================================================================*/ CPropInfoTable::CPropInfoTable() : m_fLoaded(FALSE) { // Clear the hash tables
memset(m_rgCPropIdTable, 0, PROPERTY_HASH_SIZE * sizeof(CPropInfo *)); memset(m_rgCPropNameTable, 0, PROPERTY_HASH_SIZE * sizeof(CPropInfo *)); }
/*===================================================================
CPropInfoTable::~CPropInfoTable
Destructor
Parameters: None
Returns: Nothing ===================================================================*/ CPropInfoTable::~CPropInfoTable() { if (m_fLoaded) { Unload(); } }
/*===================================================================
CPropInfoTable::Load
Loads properties from the "_Machine_/Schema/Properties" key into the property information table. On failure, recovers by unloading everything.
Parameters: pIMeta ATL Smart pointer to the metabase hMDComp Open metabase handle to "_Machine_" key
Returns: E_OUTOFMEMORY on allocation failure S_OK on success ===================================================================*/ HRESULT CPropInfoTable::Load(CComPtr<IMSAdminBase> &pIMeta, METADATA_HANDLE hMDComp) { //If it's already loaded, unload then reload
if (m_fLoaded) { Unload(); }
USES_CONVERSION; HRESULT hr; int iDataIndex; METADATA_RECORD mdrDataRec; DWORD dwReqDataLen; DWORD dwReturnBufLen; UCHAR *lpReturnBuf = NULL; unsigned int uiLoc; CPropInfo *pCNewProp; METADATA_HANDLE hMDNames = NULL; METADATA_HANDLE hMDTypes = NULL;
//Setup the return buffer
dwReturnBufLen = 1024; lpReturnBuf = new UCHAR[dwReturnBufLen]; if (lpReturnBuf == NULL) return E_OUTOFMEMORY;
// Open the Schema/Properties/Names subkey
hr = pIMeta->OpenKey(hMDComp, L"Schema/Properties/Names", METADATA_PERMISSION_READ, MUTIL_OPEN_KEY_TIMEOUT, &hMDNames); if (FAILED(hr)) { delete lpReturnBuf; return hr; };
// For each name
iDataIndex = 0; mdrDataRec.dwMDIdentifier = 0; mdrDataRec.dwMDAttributes = METADATA_NO_ATTRIBUTES; mdrDataRec.dwMDUserType = ALL_METADATA; mdrDataRec.dwMDDataType = ALL_METADATA; mdrDataRec.dwMDDataLen = dwReturnBufLen; mdrDataRec.pbMDData = (PBYTE) lpReturnBuf; mdrDataRec.dwMDDataTag = 0; hr = pIMeta->EnumData(hMDNames, NULL, &mdrDataRec, iDataIndex, &dwReqDataLen); while (SUCCEEDED(hr)) {
// Make sure we got a string
if (mdrDataRec.dwMDDataType != STRING_METADATA) { hr = HRESULT_FROM_WIN32(ERROR_INVALID_DATA); goto LError; }
// Create the property object
pCNewProp = new CPropInfo; if (pCNewProp == NULL) { hr = E_OUTOFMEMORY; goto LError; } hr = pCNewProp->Init(mdrDataRec.dwMDIdentifier); if (FAILED(hr)) { delete pCNewProp; goto LError; } hr = pCNewProp->SetName(W2T(reinterpret_cast<LPWSTR> (lpReturnBuf))); if (FAILED(hr)) { delete pCNewProp; goto LError; }
// Add it to the Id hash table
uiLoc = IdHash(mdrDataRec.dwMDIdentifier); pCNewProp->m_pCIdHashNext = m_rgCPropIdTable[uiLoc]; m_rgCPropIdTable[uiLoc] = pCNewProp;
// Add it to the Name hash table
uiLoc = NameHash(pCNewProp->m_tszName); pCNewProp->m_pCNameHashNext = m_rgCPropNameTable[uiLoc]; m_rgCPropNameTable[uiLoc] = pCNewProp;
iDataIndex++; mdrDataRec.dwMDIdentifier = 0; mdrDataRec.dwMDAttributes = METADATA_NO_ATTRIBUTES; mdrDataRec.dwMDUserType = ALL_METADATA; mdrDataRec.dwMDDataType = ALL_METADATA; mdrDataRec.dwMDDataLen = dwReturnBufLen; mdrDataRec.pbMDData = (PBYTE) lpReturnBuf; mdrDataRec.dwMDDataTag = 0; hr = pIMeta->EnumData(hMDNames, NULL, &mdrDataRec, iDataIndex, &dwReqDataLen); }
// Make sure we ran out of items
if (HRESULT_CODE(hr) != ERROR_NO_MORE_ITEMS) { goto LError; }
// Close the Schema/Properties/Names sub-key
pIMeta->CloseKey(hMDNames); hMDNames = NULL;
// Open the Schema/Properties/Types sub-key
hr = pIMeta->OpenKey(hMDComp, L"Schema/Properties/Types", METADATA_PERMISSION_READ, MUTIL_OPEN_KEY_TIMEOUT, &hMDTypes); if (FAILED(hr)) { goto LError; };
// For each type
iDataIndex = 0; mdrDataRec.dwMDIdentifier = 0; mdrDataRec.dwMDAttributes = METADATA_NO_ATTRIBUTES; mdrDataRec.dwMDUserType = ALL_METADATA; mdrDataRec.dwMDDataType = ALL_METADATA; mdrDataRec.dwMDDataLen = dwReturnBufLen; mdrDataRec.pbMDData = (PBYTE) lpReturnBuf; mdrDataRec.dwMDDataTag = 0; hr = pIMeta->EnumData(hMDTypes, NULL, &mdrDataRec, iDataIndex, &dwReqDataLen); while (SUCCEEDED(hr)) {
// Make sure we got binary data
if (mdrDataRec.dwMDDataType != BINARY_METADATA) { hr = HRESULT_FROM_WIN32(ERROR_INVALID_DATA); goto LError; }
// Look for an existing property object for this Id
pCNewProp = GetPropInfo(mdrDataRec.dwMDIdentifier); if (pCNewProp == NULL) { // Create the property object
pCNewProp = new CPropInfo; if (pCNewProp == NULL) { hr = E_OUTOFMEMORY; goto LError; } hr = pCNewProp->Init(mdrDataRec.dwMDIdentifier); if (FAILED(hr)) { delete pCNewProp; goto LError; }
// Add it to the Id hash table
uiLoc = IdHash(mdrDataRec.dwMDIdentifier); pCNewProp->m_pCIdHashNext = m_rgCPropIdTable[uiLoc]; m_rgCPropIdTable[uiLoc] = pCNewProp; }
// Add type information to the property object
pCNewProp->SetTypeInfo(reinterpret_cast<PropValue *> (lpReturnBuf));
iDataIndex++; mdrDataRec.dwMDIdentifier = 0; mdrDataRec.dwMDAttributes = METADATA_NO_ATTRIBUTES; mdrDataRec.dwMDUserType = ALL_METADATA; mdrDataRec.dwMDDataType = ALL_METADATA; mdrDataRec.dwMDDataLen = dwReturnBufLen; mdrDataRec.pbMDData = (PBYTE) lpReturnBuf; mdrDataRec.dwMDDataTag = 0; hr = pIMeta->EnumData(hMDTypes, NULL, &mdrDataRec, iDataIndex, &dwReqDataLen); }
// Make sure we ran out of items
if (HRESULT_CODE(hr) != ERROR_NO_MORE_ITEMS) { goto LError; }
// Close the Schema/Properties/Types sub-key
pIMeta->CloseKey(hMDTypes); hMDTypes = NULL;
delete lpReturnBuf;
m_fLoaded = TRUE;
return S_OK;
LError: if (hMDNames != NULL) { pIMeta->CloseKey(hMDNames); } if (hMDTypes != NULL) { pIMeta->CloseKey(hMDTypes); }
if (lpReturnBuf != NULL) { delete lpReturnBuf; }
// Cleanup the entries we loaded
Unload();
return hr; }
/*===================================================================
CPropInfoTable::Unload
Unloads the property information table.
Parameters: None
Returns: Nothing ===================================================================*/ void CPropInfoTable::Unload() { int iIndex; CPropInfo *pCDeleteProp;
//Clear the Name table
memset(m_rgCPropNameTable, 0, PROPERTY_HASH_SIZE * sizeof(CPropInfo *));
// For each Id hash table entry
for (iIndex =0; iIndex < PROPERTY_HASH_SIZE; iIndex++) { // While the entry is not empty
while (m_rgCPropIdTable[iIndex] != NULL) { // Nuke the first table entry
pCDeleteProp = m_rgCPropIdTable[iIndex]; m_rgCPropIdTable[iIndex] = pCDeleteProp->m_pCIdHashNext; delete pCDeleteProp; } }
m_fLoaded = FALSE; }
/*===================================================================
CPropInfoTable::GetPropInfo
Gets property information from the table based on property id
Parameters: dwId Id of property to get
Returns: NULL if property not found or error Pointer to CPropInfo class on success ===================================================================*/ CPropInfo *CPropInfoTable::GetPropInfo(DWORD dwId) { CPropInfo *pCCurProp;
// Go to the table location
pCCurProp = m_rgCPropIdTable[IdHash(dwId)];
// Look at all of the entries
while ((pCCurProp != NULL) && (pCCurProp->m_dwId != dwId)) { pCCurProp = pCCurProp->m_pCIdHashNext; }
return pCCurProp; // Will be NULL if not found
}
/*===================================================================
CPropInfoTable::GetPropInfo
Gets property information from the table based on property name. Case insensitive.
Parameters: tszName Name of property to get
Returns: NULL if property not found or error Pointer to CPropInfo class on success ===================================================================*/ CPropInfo *CPropInfoTable::GetPropInfo(LPCTSTR tszName) { CPropInfo *pCCurProp;
// Go to the table location
pCCurProp = m_rgCPropNameTable[NameHash(tszName)];
// Look at all of the entries
while ((pCCurProp != NULL) && (_tcsicmp(pCCurProp->m_tszName, tszName) != 0)) { pCCurProp = pCCurProp->m_pCNameHashNext; }
return pCCurProp; // Will be NULL if not found
}
/*===================================================================
CPropInfoTable::NameHash
Private function to get a hash value from a property name for the name table. Case insensitive.
Parameters: tszName Name to hash
Returns: Hash value of name ===================================================================*/ unsigned int CPropInfoTable::NameHash(LPCTSTR tszName) { ASSERT_STRING(tszName);
unsigned int uiSum; unsigned int uiIndex;
uiSum = 0; for (uiIndex=0; uiIndex < _tcslen(tszName); uiIndex++) { uiSum += _totlower(tszName[uiIndex]); }
return (uiSum % PROPERTY_HASH_SIZE); }
/*------------------------------------------------------------------
* C C l a s s P r o p I n f o */
// Everything is inline
/*------------------------------------------------------------------
* C C l a s s I n f o */
/*===================================================================
CClassInfo::CClassInfo
Constructor
Parameters: None
Returns: Nothing ===================================================================*/ CClassInfo::CClassInfo() : m_tszName(NULL), m_pCHashNext(NULL), m_fLoaded(FALSE), m_pCOptionalPropList(NULL), m_pCMandatoryPropList(NULL) { // Clear the hash table
memset(m_rgCPropTable, 0, CLASS_PROPERTY_HASH_SIZE * sizeof(CClassPropInfo *)); }
/*===================================================================
CClassInfo::Init
Constructor
Parameters: tszName Name of the class
Returns: E_OUTOFMEMORY on allocation failure S_OK on success ===================================================================*/ HRESULT CClassInfo::Init(LPCTSTR tszName) { ASSERT_STRING(tszName);
m_tszName = new TCHAR[_tcslen(tszName) + 1]; if (m_tszName == NULL) { return E_OUTOFMEMORY; } _tcscpy(m_tszName, tszName);
return S_OK; }
/*===================================================================
CClassInfo::~CClassInfo
Destructor
Parameters: None
Returns: Nothing ===================================================================*/ CClassInfo::~CClassInfo() { Unload();
if (m_tszName != NULL) { delete m_tszName; } }
/*===================================================================
CClassInfo::Load
Loads class properties from the "_Machine_/Schema/Classes/_Class_/Mandatory" and "_Machine_/Schema/Classes/_Class_/Optional" keys into the class property information table, mandatory list and optional list. On failure, recovers by unloading everything.
Parameters: pIMeta ATL Smart pointer to the metabase hMDClasses Open metabase handle to "_Machine_/Schema/Classes" key
Returns: E_OUTOFMEMORY on allocation failure S_OK on success ===================================================================*/ HRESULT CClassInfo::Load(CComPtr<IMSAdminBase> &pIMeta, METADATA_HANDLE hMDClasses) { USES_CONVERSION; HRESULT hr;
//If it's already loaded, unload then reload
if (m_fLoaded) { Unload(); }
// Open the class key
METADATA_HANDLE hMDClass = NULL; hr = pIMeta->OpenKey(hMDClasses, T2W(m_tszName), METADATA_PERMISSION_READ, 1000, &hMDClass); if (FAILED(hr)) { return hr; }
// Load the class properties
METADATA_HANDLE hMDClassProp = NULL; int iDataIndex; METADATA_RECORD mdr; DWORD dwReqDataLen; DWORD dwReturnBufLen; UCHAR *lpReturnBuf = NULL; unsigned int uiLoc; CClassPropInfo *pCNewClassProp;
//Setup the return buffer
dwReturnBufLen = 1024; lpReturnBuf = new UCHAR[dwReturnBufLen]; if (lpReturnBuf == NULL) { hr = E_OUTOFMEMORY; goto LError; }
// Load the mandatory class properties
// Open the Mandatory key
hr = pIMeta->OpenKey(hMDClass, L"Mandatory", METADATA_PERMISSION_READ, 1000, &hMDClassProp); if (FAILED(hr)) { goto LError; }
// For each Mandatory property
iDataIndex = 0; mdr.dwMDIdentifier = 0; mdr.dwMDAttributes = METADATA_NO_ATTRIBUTES; mdr.dwMDUserType = ALL_METADATA; mdr.dwMDDataType = ALL_METADATA; mdr.dwMDDataLen = dwReturnBufLen; mdr.pbMDData = (PBYTE) lpReturnBuf; mdr.dwMDDataTag = 0; hr = pIMeta->EnumData(hMDClassProp, NULL, &mdr, iDataIndex, &dwReqDataLen); while (SUCCEEDED(hr)|| (HRESULT_CODE(hr) == ERROR_INSUFFICIENT_BUFFER)) {
// Handle insufficent buffer errors
if ((HRESULT_CODE(hr) == ERROR_INSUFFICIENT_BUFFER)) { // Allocate more memory
delete lpReturnBuf; dwReturnBufLen = dwReqDataLen; lpReturnBuf = new UCHAR[dwReturnBufLen]; if (lpReturnBuf == NULL) { hr = E_OUTOFMEMORY; goto LError; } // Loop again
hr = S_OK; } else { //Buffer is big enough, proceed to add the class property
// Create the Class Property object
pCNewClassProp = new CClassPropInfo; if (pCNewClassProp == NULL) { hr = E_OUTOFMEMORY; goto LError; } hr = pCNewClassProp->Init(mdr.dwMDIdentifier, TRUE); if (FAILED(hr)) { delete pCNewClassProp; goto LError; }
//Add it to the mandatory list
pCNewClassProp->m_pCListNext = m_pCMandatoryPropList; m_pCMandatoryPropList = pCNewClassProp; //Add it to the hash table
uiLoc = Hash(mdr.dwMDIdentifier); pCNewClassProp->m_pCHashNext = m_rgCPropTable[uiLoc]; m_rgCPropTable[uiLoc] = pCNewClassProp;
iDataIndex++; }
mdr.dwMDIdentifier = 0; mdr.dwMDAttributes = METADATA_NO_ATTRIBUTES; mdr.dwMDUserType = ALL_METADATA; mdr.dwMDDataType = ALL_METADATA; mdr.dwMDDataLen = dwReturnBufLen; mdr.pbMDData = (PBYTE) lpReturnBuf; mdr.dwMDDataTag = 0; hr = pIMeta->EnumData(hMDClassProp, NULL, &mdr, iDataIndex, &dwReqDataLen); } // Make sure we ran out of items
if (HRESULT_CODE(hr) != ERROR_NO_MORE_ITEMS) { goto LError; }
// Close the Mandatory key
pIMeta->CloseKey(hMDClassProp); hMDClassProp = NULL;
// Load the optional class properties
// Open the Optional key
hr = pIMeta->OpenKey(hMDClass, L"Optional", METADATA_PERMISSION_READ, 1000, &hMDClassProp); if (FAILED(hr)) { goto LError; }
// For each Optional property
iDataIndex = 0; mdr.dwMDIdentifier = 0; mdr.dwMDAttributes = METADATA_NO_ATTRIBUTES; mdr.dwMDUserType = ALL_METADATA; mdr.dwMDDataType = ALL_METADATA; mdr.dwMDDataLen = dwReturnBufLen; mdr.pbMDData = (PBYTE) lpReturnBuf; mdr.dwMDDataTag = 0; hr = pIMeta->EnumData(hMDClassProp, NULL, &mdr, iDataIndex, &dwReqDataLen); while (SUCCEEDED(hr)|| (HRESULT_CODE(hr) == ERROR_INSUFFICIENT_BUFFER)) {
// Handle insufficent buffer errors
if ((HRESULT_CODE(hr) == ERROR_INSUFFICIENT_BUFFER)) { // Allocate more memory
delete lpReturnBuf; dwReturnBufLen = dwReqDataLen; lpReturnBuf = new UCHAR[dwReturnBufLen]; if (lpReturnBuf == NULL) { hr = E_OUTOFMEMORY; goto LError; }
// Loop again
hr = S_OK; } else { //Buffer is big enough, proceed to add the class property
// Create the Class Property object
pCNewClassProp = new CClassPropInfo; if (pCNewClassProp == NULL) { hr = E_OUTOFMEMORY; goto LError; } hr = pCNewClassProp->Init(mdr.dwMDIdentifier, FALSE); if (FAILED(hr)) { delete pCNewClassProp; goto LError; }
//Add it to the optional list
pCNewClassProp->m_pCListNext = m_pCOptionalPropList; m_pCOptionalPropList = pCNewClassProp; //Add it to the hash table
uiLoc = Hash(mdr.dwMDIdentifier); pCNewClassProp->m_pCHashNext = m_rgCPropTable[uiLoc]; m_rgCPropTable[uiLoc] = pCNewClassProp;
iDataIndex++; }
mdr.dwMDIdentifier = 0; mdr.dwMDAttributes = METADATA_NO_ATTRIBUTES; mdr.dwMDUserType = ALL_METADATA; mdr.dwMDDataType = ALL_METADATA; mdr.dwMDDataLen = dwReturnBufLen; mdr.pbMDData = (PBYTE) lpReturnBuf; mdr.dwMDDataTag = 0; hr = pIMeta->EnumData(hMDClassProp, NULL, &mdr, iDataIndex, &dwReqDataLen); }
// Make sure we ran out of items
if (HRESULT_CODE(hr) != ERROR_NO_MORE_ITEMS) { goto LError; }
// Close the Optional key
pIMeta->CloseKey(hMDClassProp);
delete lpReturnBuf; // Close the Class key
pIMeta->CloseKey(hMDClass);
m_fLoaded = TRUE;
return S_OK;
//Error durring loading, back out
LError: if (hMDClassProp != NULL) { pIMeta->CloseKey(hMDClassProp); } if (hMDClass != NULL) { pIMeta->CloseKey(hMDClass); }
if (lpReturnBuf != NULL) { delete lpReturnBuf; }
Unload();
return hr; }
/*===================================================================
CClassInfo::Unload
Unloads the class property information table.
Parameters: None
Returns: Nothing ===================================================================*/ void CClassInfo::Unload() { int iIndex; CClassPropInfo *pCDeleteProp;
// Clear the lists
m_pCOptionalPropList = NULL; m_pCMandatoryPropList = NULL;
// For each hash table entry
for (iIndex =0; iIndex < CLASS_PROPERTY_HASH_SIZE; iIndex++) { // While the entry is not empty
while (m_rgCPropTable[iIndex] != NULL) { // Nuke the first table entry
pCDeleteProp = m_rgCPropTable[iIndex]; m_rgCPropTable[iIndex] = pCDeleteProp->m_pCHashNext; delete pCDeleteProp; } }
m_fLoaded = FALSE; }
/*===================================================================
CClassInfo::GetProperty
Get the CClassPropInfo (class property info) object from the hash table given the property id.
Parameters: dwId Identifier of the property to get
Returns: NULL on failure Pointer to the CClassPropInfo object on success ===================================================================*/ CClassPropInfo *CClassInfo::GetProperty(DWORD dwId) { CClassPropInfo *pCCurProp;
// Go to the table location
pCCurProp = m_rgCPropTable[Hash(dwId)];
// Look at all of the entries
while ((pCCurProp != NULL) && (pCCurProp->m_dwId != dwId)) { pCCurProp = pCCurProp->m_pCHashNext; }
return pCCurProp; // Will be NULL if not found
}
/*------------------------------------------------------------------
* C C l a s s I n f o T a b l e */
/*===================================================================
CClassInfoTable::CClassInfoTable
Constructor
Parameters: None
Returns: Nothing ===================================================================*/ CClassInfoTable::CClassInfoTable() : m_fLoaded(FALSE) { // Clear the hash table
memset(m_rgCClassTable, 0, CLASS_HASH_SIZE * sizeof(CClassInfo *)); }
/*===================================================================
CClassInfoTable::~CClassInfoTable
Destructor
Parameters: None
Returns: Nothing ===================================================================*/ CClassInfoTable::~CClassInfoTable() { if (m_fLoaded) { Unload(); } }
/*===================================================================
CClassInfoTable::Load
Loads classes from the "_Machine_/Schema/Classes" key into the class information table. On failure, recovers by unloading everything.
Parameters: pIMeta ATL Smart pointer to the metabase hMDComp Open metabase handle to "_Machine_" key
Returns: E_OUTOFMEMORY on allocation failure S_OK on success ===================================================================*/ HRESULT CClassInfoTable::Load(CComPtr<IMSAdminBase> &pIMeta, METADATA_HANDLE hMDComp) { ASSERT(pIMeta.p != NULL);
USES_CONVERSION; HRESULT hr;
//If it's already loaded, unload then reload
if (m_fLoaded) { Unload(); } int iKeyIndex; wchar_t wszSubKey[ADMINDATA_MAX_NAME_LEN]; LPTSTR tszSubKey; int iLoc; CClassInfo *pCNewClass;
//Load the classes
METADATA_HANDLE hMDClasses = NULL;
// Open the Schema/Classes subkey
hr = pIMeta->OpenKey(hMDComp, L"Schema/Classes", METADATA_PERMISSION_READ, 1000, &hMDClasses); if (FAILED(hr)) { return hr; };
// For each subkey
iKeyIndex = 0; hr = pIMeta->EnumKeys(hMDClasses, NULL, wszSubKey, iKeyIndex); while (SUCCEEDED(hr)) { tszSubKey = W2T(wszSubKey);
// Create the new class
pCNewClass = new CClassInfo; if (pCNewClass == NULL) { hr = E_OUTOFMEMORY; goto LError; } hr = pCNewClass->Init(tszSubKey); if (FAILED(hr)) { delete pCNewClass; goto LError; }
// Load the class properties
hr = pCNewClass->Load(pIMeta, hMDClasses); if (FAILED(hr)) { delete pCNewClass; goto LError; }
// Add it to the hash table
iLoc = Hash(tszSubKey); pCNewClass->m_pCHashNext = m_rgCClassTable[iLoc]; m_rgCClassTable[iLoc] = pCNewClass;
iKeyIndex++; hr = pIMeta->EnumKeys(hMDClasses, NULL, wszSubKey, iKeyIndex); }
//Make sure we ran out of items
if (!(HRESULT_CODE(hr) == ERROR_NO_MORE_ITEMS)) { goto LError; }
// Close the schema properties key
pIMeta->CloseKey(hMDClasses);
m_fLoaded = TRUE;
return S_OK;
LError: if (hMDClasses != NULL) { pIMeta->CloseKey(hMDClasses); }
// Cleanup the entries we loaded
Unload();
return hr; }
/*===================================================================
CClassInfo::Unload
Unloads the class information table.
Parameters: None
Returns: Nothing ===================================================================*/ void CClassInfoTable::Unload() { int iIndex; CClassInfo *pCDeleteClass;
// For each hash table entry
for (iIndex =0; iIndex < CLASS_HASH_SIZE; iIndex++) { // While the entry is not empty
while (m_rgCClassTable[iIndex] != NULL) { // Nuke the first table entry
pCDeleteClass = m_rgCClassTable[iIndex]; m_rgCClassTable[iIndex] = pCDeleteClass->m_pCHashNext; delete pCDeleteClass; } }
m_fLoaded = FALSE; }
/*===================================================================
CCClasssInfoTable::GetClassInfo
Get the CClassInfo (class info) object from the hash table given the class name
Parameters: tszClassName Name of the class to get info for
Returns: NULL on failure Pointer to the CClassInfo object on success ===================================================================*/ CClassInfo *CClassInfoTable::GetClassInfo(LPCTSTR tszName) { ASSERT_STRING(tszName);
CClassInfo *pCCurClass;
// Go to the table location
pCCurClass = m_rgCClassTable[Hash(tszName)];
// Look at all of the entries
while ((pCCurClass != NULL) && (_tcscmp(pCCurClass->m_tszName, tszName) != 0)) { pCCurClass = pCCurClass->m_pCHashNext; }
return pCCurClass; // Will be NULL if not found
}
/*===================================================================
CClassInfoTable::Hash
Private function to get a hash value from a class name for the class table.
Parameters: tszName Name to hash
Returns: Hash value of name ===================================================================*/ unsigned int CClassInfoTable::Hash(LPCTSTR tszName) { ASSERT_STRING(tszName);
unsigned int uiSum; unsigned int uiIndex;
uiSum = 0; for (uiIndex=0; uiIndex < _tcslen(tszName); uiIndex++) { uiSum += tszName[uiIndex]; }
return (uiSum % CLASS_HASH_SIZE); }
/*------------------------------------------------------------------
* C M e t a S c h e m a */
/*===================================================================
CMetaSchema::Init
Constructor
Parameters: pIMeta ATL Smart pointer to the metabase tszMachineName Name of machine the schema is for
Returns: E_OUTOFMEMORY if allocation fails S_OK on success ===================================================================*/ HRESULT CMetaSchema::Init(const CComPtr<IMSAdminBase> &pIMeta, LPCTSTR tszMachineName) { ASSERT(pIMeta.p != NULL); ASSERT_STRING(tszMachineName);
m_pIMeta = pIMeta;
m_tszMachineName = new TCHAR[_tcslen(tszMachineName) + 1]; if (m_tszMachineName == NULL) return E_OUTOFMEMORY; _tcscpy(m_tszMachineName, tszMachineName);
return S_OK; }
/*===================================================================
CMetaSchema::GetPropInfo
Get the CPropInfo (property info) object for a given id
Parameters: dwId Id of property to get info for
Returns: NULL on failure Pointer to the CPropInfo object on success ===================================================================*/ CPropInfo *CMetaSchema::GetPropInfo(DWORD dwId) { // Make sure the property table is up to date
if (m_fPropTableDirty) { HRESULT hr;
hr = LoadPropTable(); if (FAILED(hr)) { return NULL; } }
// Pass on the call
return m_CPropInfoTable.GetPropInfo(dwId); }
/*===================================================================
CMetaSchema::GetPropInfo
Get the CPropInfo (property info) object for a given name
Parameters: tszName Name of property to get info for
Returns: NULL on failure Pointer to the CPropInfo object on success ===================================================================*/ CPropInfo *CMetaSchema::GetPropInfo(LPCTSTR tszName) { ASSERT_STRING(tszName);
// Make sure the property table is up to date
if (m_fPropTableDirty) { HRESULT hr;
hr = LoadPropTable(); if (FAILED(hr)) { return NULL; } }
// Pass on the call
return m_CPropInfoTable.GetPropInfo(tszName); }
/*===================================================================
CMetaSchema::GetClassInfo
Get the CClassInfo (class info) object for a given class name
Parameters: tszClassName Name of the class to get info for
Returns: NULL on failure Pointer to the CClassInfo object on success ===================================================================*/ CClassInfo *CMetaSchema::GetClassInfo(LPCTSTR tszClassName) { ASSERT_STRING(tszClassName);
// Make sure the class table is up to date
if (m_fClassTableDirty) { HRESULT hr;
hr = LoadClassTable(); if (FAILED(hr)) { return NULL; } }
// Pass on the call
return m_CClassInfoTable.GetClassInfo(tszClassName); }
/*===================================================================
CMetaSchema:::GetClassPropInfo
Get the CClassPropInfo (class property info) object for a given class name and property id.
Parameters: tszClassName Name of the class get property from dwPropId Id of property to get info for
Returns: NULL on failure Pointer to the CClassPropInfo object on success ===================================================================*/ CClassPropInfo *CMetaSchema::GetClassPropInfo(LPCTSTR tszClassName, DWORD dwPropId) { // Make sure the class table is up to date
if (m_fClassTableDirty) { HRESULT hr;
hr = LoadClassTable(); if (FAILED(hr)) { return NULL; } }
// Get the class
CClassInfo *pCClassInfo;
pCClassInfo = m_CClassInfoTable.GetClassInfo(tszClassName); if (pCClassInfo == NULL) { return NULL; } else { // Pass on the call
return pCClassInfo->GetProperty(dwPropId); } }
/*===================================================================
CMetaSchema::GetMandatoryClassPropList
Get the list of optional class properties for a class name.
Parameters: tszClassName Name of the class get the properties from
Returns: NULL on failure Pointer to the first optional CClassPropInfo object on success ===================================================================*/ CClassPropInfo *CMetaSchema::GetMandatoryClassPropList(LPCTSTR tszClassName) { // Make sure the class table is up to date
if (m_fClassTableDirty) { HRESULT hr;
hr = LoadClassTable(); if (FAILED(hr)) { return NULL; } }
// Get the class
CClassInfo *pCClassInfo;
pCClassInfo = m_CClassInfoTable.GetClassInfo(tszClassName); if (pCClassInfo == NULL) { return NULL; } else { // Pass on the call
return pCClassInfo->GetMandatoryPropList(); } }
/*===================================================================
CMetaSchema::GetOptionalClassPropList
Get the list of optional class properties for a class name.
Parameters: tszClassName Name of the class get the properties from
Returns: NULL on failure Pointer to the first optional CClassPropInfo object on success ===================================================================*/ CClassPropInfo *CMetaSchema::GetOptionalClassPropList(LPCTSTR tszClassName) { // Make sure the class table is up to date
if (m_fClassTableDirty) { HRESULT hr;
hr = LoadClassTable(); if (FAILED(hr)) { return NULL; } }
// Get the class
CClassInfo *pCClassInfo;
pCClassInfo = m_CClassInfoTable.GetClassInfo(tszClassName); if (pCClassInfo == NULL) { return NULL; } else { // Pass on the call
return pCClassInfo->GetOptionalPropList(); } }
/*===================================================================
CMetaSchema::ChangeNotification
Processes change events effecting the machine where the schema is located. If the dirty flag for the property and class tables is not already set a call to Unload() is made to free up memory no longer needed.
Parameters: tszChangedKey Cannonized key where change took place pcoChangeObject Pointer to the change event information
Returns: Nothing ===================================================================*/ void CMetaSchema::ChangeNotification(LPTSTR tszKey, MD_CHANGE_OBJECT *pcoChangeObject) { ASSERT_POINTER(pcoChangeObject, MD_CHANGE_OBJECT);
USES_CONVERSION; LPTSTR tszChangedKey;
tszChangedKey = tszKey;
// Skip the slash
if (*tszChangedKey != _T('\0') && *tszChangedKey == _T('/')) { tszChangedKey++; }
if (_tcsnicmp(tszChangedKey, _T("schema/"), 7) == 0) { // It effects a "Schema" subkey
if ((_tcsnicmp(tszChangedKey, _T("schema/properties/"), 18) == 0) || (_tcsicmp(tszChangedKey, _T("schema/properties")) == 0)) { // It effects "Schema/Properties"
if (!m_fPropTableDirty) { // Unload the prop table
m_CPropInfoTable.Unload(); } m_fPropTableDirty = TRUE; } else if ((_tcsnicmp(tszChangedKey, _T("schema/classes/"), 15) == 0) || (_tcsicmp(tszChangedKey, _T("schema/classes")) == 0)) { // It effects "Schema/Classes"
if (!m_fClassTableDirty) { // Unload the class table
m_CClassInfoTable.Unload(); } m_fClassTableDirty = TRUE; } } else if (_tcsicmp(tszChangedKey, _T("schema")) == 0) { // Just the "Schema" key was changed
if (!m_fPropTableDirty) { // Unload the prop table
m_CPropInfoTable.Unload(); } m_fPropTableDirty = TRUE;
if (!m_fClassTableDirty) { // Unload the class table
m_CClassInfoTable.Unload(); } m_fClassTableDirty = TRUE; } }
/*===================================================================
CMetaSchema::LoadPropTable
(Re)loads a dirty property table
Parameters: None
Returns: S_OK on success ===================================================================*/ HRESULT CMetaSchema::LoadPropTable() { USES_CONVERSION; HRESULT hr;
// Open the Machine key
METADATA_HANDLE hMDKey;
hr = m_pIMeta->OpenKey(METADATA_MASTER_ROOT_HANDLE, L"", // schema path moved to /schema
METADATA_PERMISSION_READ, MUTIL_OPEN_KEY_TIMEOUT, &hMDKey); if (FAILED(hr)) { return hr; }
// Load the properties
hr = m_CPropInfoTable.Load(m_pIMeta, hMDKey); if (FAILED(hr)) { return hr; }
// Close the Machine key
m_pIMeta->CloseKey(hMDKey);
m_fPropTableDirty = FALSE;
return S_OK; }
/*===================================================================
CMetaSchema::LoadClassTable
(Re)loads a dirty class table
Parameters: None
Returns: S_OK on success ===================================================================*/ HRESULT CMetaSchema::LoadClassTable() { USES_CONVERSION; HRESULT hr;
// Open the Machine key
METADATA_HANDLE hMDKey;
hr = m_pIMeta->OpenKey(METADATA_MASTER_ROOT_HANDLE, L"", // schema path moved to /schema
METADATA_PERMISSION_READ, MUTIL_OPEN_KEY_TIMEOUT, &hMDKey); if (FAILED(hr)) { return hr; }
// Load the properties
hr = m_CClassInfoTable.Load(m_pIMeta, hMDKey); if (FAILED(hr)) { return hr; }
// Close the Machine key
m_pIMeta->CloseKey(hMDKey);
m_fClassTableDirty = FALSE;
return S_OK; }
/*------------------------------------------------------------------
* C M e t a S c h e m a T a b l e */
/*===================================================================
CMetaSchemaTable::CMetaSchemaTable
Constructor
Parameters: None
Returns: Nothing ===================================================================*/ CMetaSchemaTable::CMetaSchemaTable() : m_dwNumRef(1), m_fLoaded(FALSE) { m_CMSAdminBaseSink = new CComObject<CMSAdminBaseSink>; m_CMSAdminBaseSink->AddRef();
// Clear the hash table
memset(m_rgCSchemaTable, 0, SCHEMA_HASH_SIZE * sizeof(CMetaSchema *)); }
/*===================================================================
CMetaSchemaTable::~CMetaSchemaTable
Destructor
Parameters: None
Returns: Nothing ===================================================================*/ CMetaSchemaTable::~CMetaSchemaTable() { TRACE0("MetaUtil: CMetaSchemaTable::~CMetaSchemaTable\n");
if (m_fLoaded) { Unload(); }
DWORD dwTemp;
if (m_CMSAdminBaseSink != NULL) { dwTemp = m_CMSAdminBaseSink->Release();
TRACE1("MetaUtil: CMetaSchemaTable::~CMetaSchemaTable Release Sink %i\n", dwTemp); } }
/*===================================================================
CMetaSchemaTable::Load
Loads/Creates the schema information for all of the machines
Parameters: None
Returns: Nothing ===================================================================*/ void CMetaSchemaTable::Load() { USES_CONVERSION; HRESULT hr;
if (m_fLoaded) { Unload(); }
// Create an instance of the Metabase Admin Base Object
// Need a seperate instance so we pick up changes made
// by our "parent" MetaUtil object family.
hr = ::CoCreateInstance(CLSID_MSAdminBase, NULL, CLSCTX_ALL, IID_IMSAdminBase, (void **)&m_pIMeta); if (FAILED(hr)) { m_pIMeta = NULL; return; }
// Build the schema list
int iKeyIndex; wchar_t wszMDSubKey[ADMINDATA_MAX_NAME_LEN]; CMetaSchema *pCNewSchema; int iLoc;
// For each subkey of root
iKeyIndex = 0; hr = m_pIMeta->EnumKeys(METADATA_MASTER_ROOT_HANDLE, NULL, wszMDSubKey, iKeyIndex); while (SUCCEEDED(hr)) { // Create the new schema
pCNewSchema = new CMetaSchema; if (pCNewSchema == NULL) { goto LError; } hr = pCNewSchema->Init(m_pIMeta, W2T(wszMDSubKey)); if (FAILED(hr)) { delete pCNewSchema; goto LError; }
// Add it to the hash table
iLoc = Hash(W2T(wszMDSubKey)); pCNewSchema->m_pCNextSchema = m_rgCSchemaTable[iLoc]; m_rgCSchemaTable[iLoc] = pCNewSchema;
// Next
iKeyIndex++; hr = m_pIMeta->EnumKeys(METADATA_MASTER_ROOT_HANDLE, NULL, wszMDSubKey, iKeyIndex); }
// Make sure we ran out of items
if (HRESULT_CODE(hr) != ERROR_NO_MORE_ITEMS) { goto LError; }
// Setup notification
if (m_CMSAdminBaseSink != NULL) { m_CMSAdminBaseSink->Connect(m_pIMeta, this); }
m_fLoaded = TRUE;
return;
LError: // Back out of the load
Unload(); }
/*===================================================================
CMetaSchemaTable::Unload
Unloads the schema table.
Parameters: None
Returns: Nothing ===================================================================*/ void CMetaSchemaTable::Unload() { int iIndex; CMetaSchema *pCDelete;
// Stop notification
if (m_CMSAdminBaseSink != NULL) { m_CMSAdminBaseSink->Disconnect(); }
m_pIMeta = NULL;
// For each hash table entry
for (iIndex =0; iIndex < SCHEMA_HASH_SIZE; iIndex++) { // While the entry is not empty
while (m_rgCSchemaTable[iIndex] != NULL) { // Nuke the first table entry
pCDelete = m_rgCSchemaTable[iIndex]; m_rgCSchemaTable[iIndex] = pCDelete->m_pCNextSchema; delete pCDelete; } }
m_fLoaded = FALSE; }
/*===================================================================
CMetaSchemaTable::GetPropInfo
Get the CPropInfo (property info) object for a given key and id
Parameters: tszKey Key the property is located under dwPropId Id of the property to get info for
Returns: NULL on failure Pointer to the CPropInfo object on success ===================================================================*/ CPropInfo *CMetaSchemaTable::GetPropInfo(LPCTSTR tszKey, DWORD dwPropId) { ASSERT_STRING(tszKey);
if (!m_fLoaded) { Load(); }
CMetaSchema *pCSchema; pCSchema = GetSchema(tszKey);
// If found then pass the call on
if (pCSchema != NULL) { return pCSchema->GetPropInfo(dwPropId); } else { return NULL; } }
/*===================================================================
CMetaSchemaTable::GetPropInfo
Get the CPropInfo (property info) object for a given key and name
Parameters: tszKey Key the property is located under tszPropName Name of the property to get info for
Returns: NULL on failure Pointer to the CPropInfo object on success ===================================================================*/ CPropInfo *CMetaSchemaTable::GetPropInfo(LPCTSTR tszKey, LPCTSTR tszPropName) { ASSERT_STRING(tszKey); ASSERT_STRING(tszPropName);
if (!m_fLoaded) { Load(); }
CMetaSchema *pCSchema; pCSchema = GetSchema(tszKey);
// If found then pass the call on
if (pCSchema != NULL) { return pCSchema->GetPropInfo(tszPropName); } else { return NULL; } }
/*===================================================================
CMetaSchemaTable::GetClassInfo
Get the CClassInfo (class info) object for a given key and class name
Parameters: tszKey Approxiamte key the class is located under. Used to get the machine name. tszClassName Name of the class to get info for
Returns: NULL on failure Pointer to the CClassInfo object on success ===================================================================*/ CClassInfo *CMetaSchemaTable::GetClassInfo(LPCTSTR tszKey, LPCTSTR tszClassName) { ASSERT_STRING(tszKey); ASSERT_STRING(tszClassName);
if (!m_fLoaded) { Load(); }
CMetaSchema *pCSchema; pCSchema = GetSchema(tszKey);
// If found then pass the call on
if (pCSchema != NULL) { return pCSchema->GetClassInfo(tszClassName); } else { return NULL; } }
/*===================================================================
CMetaSchemaTable::GetClassPropInfo
Get the CClassPropInfo (class property info) object for a given key, class name and property id.
Parameters: tszKey Approxiamte key the class is located under. Used to get the machine name. tszClassName Name of the class get property from dwPropId Id of property to get info for
Returns: NULL on failure Pointer to the CClassPropInfo object on success ===================================================================*/ CClassPropInfo *CMetaSchemaTable::GetClassPropInfo(LPCTSTR tszKey, LPCTSTR tszClassName, DWORD dwPropId) { ASSERT_STRING(tszKey); ASSERT_STRING(tszClassName);
if (!m_fLoaded) { Load(); }
CMetaSchema *pCSchema; pCSchema = GetSchema(tszKey);
// If found then pass the call on
if (pCSchema != NULL) { return pCSchema->GetClassPropInfo(tszClassName, dwPropId); } else { return NULL; } }
/*===================================================================
CMetaSchemaTable::GetMandatoryClassPropList
Get the list of mandatory class properties for a given key and class name.
Parameters: tszKey Approxiamte key the class is located under. Used to get the machine name. tszClassName Name of the class get the properties from
Returns: NULL on failure Pointer to the first mandatory CClassPropInfo object on success ===================================================================*/ CClassPropInfo *CMetaSchemaTable::GetMandatoryClassPropList(LPCTSTR tszKey, LPCTSTR tszClassName) { ASSERT_STRING(tszKey); ASSERT_STRING(tszClassName);
if (!m_fLoaded) { Load(); }
CMetaSchema *pCSchema; pCSchema = GetSchema(tszKey);
// If found then pass the call on
if (pCSchema != NULL) { return pCSchema->GetMandatoryClassPropList(tszClassName); } else { return NULL; } }
/*===================================================================
CMetaSchemaTable::GetOptionalClassPropList
Get the list of optional class properties for a given key and class name.
Parameters: tszKey Approxiamte key the class is located under. Used to get the machine name. tszClassName Name of the class get the properties from
Returns: NULL on failure Pointer to the first optional CClassPropInfo object on success ===================================================================*/ CClassPropInfo *CMetaSchemaTable::GetOptionalClassPropList(LPCTSTR tszKey, LPCTSTR tszClassName) { ASSERT_STRING(tszKey); ASSERT_STRING(tszClassName);
if (!m_fLoaded) { Load(); } CMetaSchema *pCSchema; pCSchema = GetSchema(tszKey);
// If found then pass the call on
if (pCSchema != NULL) { return pCSchema->GetOptionalClassPropList(tszClassName); } else { return NULL; } }
/*===================================================================
CMetaSchemaTable::SinkNotify
Metabase change notification callback from CMSAdminBaseSink. Either determines a need to reload all of the schema information or sends the message on to the appropriate CMetaSchema object.
Parameters: dwMDNumElements Number of change events pcoChangeObject Array of change events
Returns: S_OK always ===================================================================*/ HRESULT CMetaSchemaTable::SinkNotify(DWORD dwMDNumElements, MD_CHANGE_OBJECT pcoChangeObject[]) { ASSERT(IsValidAddress(pcoChangeObject, dwMDNumElements * sizeof(MD_CHANGE_OBJECT), FALSE));
USES_CONVERSION; DWORD dwIndex; CMetaSchema *pCMetaSchema;
// For each event
for (dwIndex = 0; dwIndex < dwMDNumElements; dwIndex++) { // Figure out what machine it's for
TCHAR tszKey[ADMINDATA_MAX_NAME_LEN]; _tcscpy(tszKey, W2T(pcoChangeObject[dwIndex].pszMDPath)); CannonizeKey(tszKey); pCMetaSchema = GetSchema(tszKey);
// If the machine is not found
if (pCMetaSchema == NULL) { // Reload the schema table
Load(); } else { // Send it to the appropriate machine
pCMetaSchema->ChangeNotification(tszKey, &(pcoChangeObject[dwIndex])); } }
return S_OK; }
/*===================================================================
CMetaSchemaTable::GetSchema
Get the schema object that contains information on the given key.
Parameters: tszKey Approxiamte key to get schema information for.
Returns: NULL on failure Pointer to the CMetaSchema object on success ===================================================================*/ CMetaSchema *CMetaSchemaTable::GetSchema(LPCTSTR tszKey) {
// Extract the machine name
TCHAR tszMachineName[ADMINDATA_MAX_NAME_LEN]; ::GetMachineFromKey(tszKey, tszMachineName);
// Find the right schema
CMetaSchema *pCCurSchema; pCCurSchema =m_rgCSchemaTable[Hash(tszMachineName)]; while ((pCCurSchema != NULL) && (_tcsicmp(pCCurSchema->m_tszMachineName, tszMachineName) != 0)) { pCCurSchema = pCCurSchema->m_pCNextSchema; }
return pCCurSchema; // Will be NULL if not found
}
/*===================================================================
CMetaSchemaTable::Hash
Private function to get a hash value from a machine name for the schema table.
Parameters: tszName Machinea name to hash
Returns: Hash value of name ===================================================================*/ unsigned int CMetaSchemaTable::Hash(LPCTSTR tszName) { ASSERT_STRING(tszName);
unsigned int uiSum; unsigned int uiIndex;
uiSum = 0; for (uiIndex=0; uiIndex < _tcslen(tszName); uiIndex++) { uiSum += _totlower(tszName[uiIndex]); }
return (uiSum % SCHEMA_HASH_SIZE); }
/*------------------------------------------------------------------
* C M S A d m i n B a s e S i n k */
/*===================================================================
CMSAdminBaseSink::CMSAdminBaseSink
Constructor
Parameters: None
Returns: Nothing ===================================================================*/ CMSAdminBaseSink::CMSAdminBaseSink() : m_fConnected(FALSE), m_dwCookie(0), m_pCMetaSchemaTable(NULL) { }
/*===================================================================
CMSAdminBaseSink::~CMSAdminBaseSink
Destructor
Parameters: None
Returns: Nothing ===================================================================*/ CMSAdminBaseSink::~CMSAdminBaseSink() { TRACE0("MetaUtil: CMSAdminBaseSink::~CMSAdminBaseSink !!!!!!!!!!!\n");
// Make sure we disconnected
if (m_fConnected) { Disconnect(); } }
/*===================================================================
CMSAdminBaseSink::SinkNotify
Entry point for notification events from the metabase admin base object.
Parameters: dwMDNumElements Number of change events pcoChangeObject Array of change events
Returns: E_FAIL if m_pCMetaSchemaTable == NULL S_OK on success ===================================================================*/ STDMETHODIMP CMSAdminBaseSink::SinkNotify(DWORD dwMDNumElements, MD_CHANGE_OBJECT pcoChangeObject[]) { TRACE0("MetaUtil: CMSAdminBaseSink::SinkNotify\n"); ASSERT(IsValidAddress(pcoChangeObject, dwMDNumElements * sizeof(MD_CHANGE_OBJECT), FALSE));
if (m_pCMetaSchemaTable == NULL) { return E_FAIL; }
// Pass on the notification
return m_pCMetaSchemaTable->SinkNotify(dwMDNumElements, pcoChangeObject); }
/*===================================================================
CMSAdminBaseSink::ShutdownNotify
Entry point for the shutdown notification event from the metabase admin base object.
Parameters: None
Returns: ERROR_NOT_SUPPORTE always ===================================================================*/ STDMETHODIMP CMSAdminBaseSink::ShutdownNotify() { return HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED); }
/*===================================================================
CMSAdminBaseSink::Connect
Begins notification of change events. Connects to the metabase admin base object.
Parameters: pIMeta Pointer to the metabase admin base object pCMetaSchemaTable Pointer to the schema table so that events can be sent back to it.
Returns: E_NOINTERFACE if can not convert IMSAdminBase to IConnectionPointContainer. S_OK on success ===================================================================*/ HRESULT CMSAdminBaseSink::Connect(CComPtr<IMSAdminBase> &pIMeta, CMetaSchemaTable *pCMetaSchemaTable) { ASSERT(pIMeta.p != NULL); ASSERT_POINTER(pCMetaSchemaTable, CMetaSchemaTable);
HRESULT hr;
if (m_fConnected) { Disconnect(); }
m_pCMetaSchemaTable = pCMetaSchemaTable;
// Get the connection container
CComQIPtr<IConnectionPointContainer, &IID_IConnectionPointContainer> pIMetaConnContainer;
pIMetaConnContainer = pIMeta; if (pIMetaConnContainer == NULL) { // Failure to change interfaces
return E_NOINTERFACE; }
// Get the connection point
hr = pIMetaConnContainer->FindConnectionPoint(IID_IMSAdminBaseSink, &m_pIMetaConn); if (FAILED(hr)) { return hr; }
// Advise (connect)
AddRef(); m_pIMetaConn->Advise((IMSAdminBaseSink *) this, &m_dwCookie);
m_fConnected = TRUE;
return S_OK; }
/*===================================================================
CMSAdminBaseSink::Disconnect
Stops notification of change events. Disconnects from the metabase admin base object.
Parameters: None
Returns: Nothing ===================================================================*/ void CMSAdminBaseSink::Disconnect() { if (!m_fConnected) { // Not connected
return; }
// Stop notification
m_pIMetaConn->Unadvise(m_dwCookie);
// No longer needed
m_pIMetaConn = NULL; m_pCMetaSchemaTable = NULL;
m_fConnected = FALSE; }
|