IDataModelManager::CreateMetadataStore-Methode (dbgmodel.h)

Die CreateMetadataStore-Methode erstellt einen Schlüsselspeicher - einen vereinfachten Container aus Schlüssel-Wert-/Metadatentupeln -, der verwendet wird, um Metadaten zu speichern, die Eigenschaften und einer Vielzahl anderer Werte zugeordnet werden können.

Ein Metadatenspeicher kann über ein einzelnes übergeordnetes Element verfügen (das wiederum über ein einzelnes übergeordnetes Element verfügen kann). Wenn sich ein bestimmter Metadatenschlüssel nicht in einem bestimmten Speicher befindet, werden die übergeordneten Schlüssel überprüft. Die meisten Metadatenspeicher haben keine übergeordneten Elemente. Es bietet jedoch eine Möglichkeit, allgemeine Metadaten einfach zu teilen.

Syntax

HRESULT CreateMetadataStore(
  IKeyStore *parentStore,
  IKeyStore **metadataStore
);

Parameter

parentStore

Der übergeordnete Speicher für den neu erstellten Metadatenspeicher. Dies kann NULL sein, wenn kein übergeordnetes Element vorhanden ist.

metadataStore

Der neu erstellte Metadatenspeicher wird hier zurückgegeben.

Rückgabewert

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

Hinweise

Beispielcode

ComPtr<IDataModelManager> spManager; /* get the data model manager */

// Create an empty key store (the usual case) which will be later filled with metadata.
ComPtr<IKeyStore> spMetadata;
if (SUCCEEDED(spManager->CreateMetadataStore(nullptr, &spMetadata)))
{
    // spMetadata now is an empty store.  You can set key values 
    // like 'PreferredRadix', 'PreferredFormat', 'PreferredLength', etc...
    ComPtr<IKeyStore> spChildMetadata;
    if (SUCCEEDED(spManager->CreateMetadataStore(spMetadata.Get(), &spChildMetadata)))
    {
        // spChildMetadata now is an empty store.  If a key queried from 
        // it does not exist there, it will be queried from spMetadata.
        // This can be useful to override properties on some store without
        // modifying or copying it.
    }
}

Anforderungen

Anforderung Wert
Header dbgmodel.h

Weitere Informationen

IDataModelManager-Schnittstelle