IDataModelManager::RegisterNamedModel-Methode (dbgmodel.h)
Die RegisterNamedModel-Methode registriert ein bestimmtes Datenmodell unter einem bekannten Namen, sodass es von Clients gefunden werden kann, die es erweitern möchten. Dies ist der Hauptzweck der API, um ein Datenmodell als etwas zu veröffentlichen, das erweitert werden kann, indem das unter diesem bekannten Namen registrierte Modell abgerufen und ein übergeordnetes Modell hinzugefügt wird. Die im Argument modelName übergebene Zeichenfolge kann zwar beliebig sein (es handelt sich nur um einen Namen), aber es gibt die Konvention, dass sie wie ein punkttrennter Namespace in der folgenden Form aussieht:
• Debugger.Models.* - Data models which pertain to the debug target.
• DataModel.Models.* - Data models which pertain to the core data model itself.
o DataModel.Models.Concepts.* - Data models which pertain to concepts in the data model.
Ein Beispiel für einen solchen Namen ist Debugger.Models.Process. Dies ist der Name, unter dem das Konzept eines Prozesses des Debuggers registriert wird. Ein Client, der den Prozess erweitert und selbst erweiterbar ist, kann seinen Erweiterbarkeitspunkt als Debugger.Models.Process.NamedExtensionPoint registrieren, wobei NamedExtensionPoint auf die Semantik verweist, die dem Prozess hinzugefügt wird.
Wenn ein bestimmtes Datenmodell unter einem Namen registriert ist, muss die Implementierung von IDataModelConcept für dieses Datenmodell über eine GetName-Methode verfügen, die den namen zurückgibt, der über den Aufruf dieser RegisterNamedModel-Methode registriert wurde.
Syntax
HRESULT RegisterNamedModel(
PCWSTR modelName,
IModelObject *modeObject
);
Parameter
modelName
Der Stammnamespace des Datenmodells wird hier zurückgegeben.
modeObject
Das datenmodell, das registriert wird.
Rückgabewert
Diese Methode gibt HRESULT zurück, das den Erfolg oder Fehler angibt.
Hinweise
Beispielcode
ComPtr<IDataModelManager> spManager; /* get the data model manager */
ComPtr<IModelObject> spDataModelObject; /* get your data model object (see
CreateDataModelObject) */
// If the model is registered under a name (e.g.:
// Debugger.Models.Process.PrivateProcessExtension as below), the
// IDataModelConcept::GetName method must return one of the registration
// names (the one the extension considers "canonical"). It is legal for an
// object to be registered under multiple names.
if (SUCCEEDED(spManager->RegisterNamedModel(
L"Debugger.Models.Process.PrivateProcessExtension",
spDataModelObject.Get()))
)
{
// The model object spDataModelObject is now registered and can be looked up
// under the name "Debugger.Models.Process.PrivateProcessExtension".
// This means others can extend it by fetching that name.
//
// Fetch it back as example:
ComPtr<IModelObject> spFetchedModel;
if (SUCCEEDED(spManager->AcquireNamedModel(
L"Debugger.Models.Process.PrivateProcessExtension",
&spFetchedModel))
)
{
// spFetchedModel should be the same as spDataModelObject
}
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |