IDataModelManager4::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. Während die im ModelName-Argument übergebene Zeichenfolge alles sein kann (es ist nur ein Name), gibt es eine Konvention, die wie ein punkttrennter Namespace des folgenden Formulars 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 des Debuggers für einen Prozess 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.

Beachten Sie, dass bei der Registrierung eines bestimmten Datenmodells unter einem Namen die Implementierung von IDataModelConcept für dieses Datenmodell über eine GetName-Methode verfügen muss, 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 zu registrierende Datenmodell.

Rückgabewert

Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.

Bemerkungen

Beispielcode-

ComPtr<IDataModelManager4> 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

Siehe auch

IDataModelManager4-Schnittstelle