IKeyStore::SetKey-Methode (dbgmodel.h)

  • Artikel

Die SetKey-Methode entspricht der SetKey-Methode auf IModelObject. Dies ist die einzige Methode, die einen Schlüssel erstellen und ihm Metadaten innerhalb des Schlüsselspeichers zuordnen kann.

Syntax

HRESULT SetKey(
  PCWSTR       key,
  IModelObject *object,
  IKeyStore    *metadata
);

Parameter

key

Der Name des Schlüssels, für den ein Wert erstellt oder festgelegt werden soll.

object

Der Wert des Schlüssels.

metadata

Optionale Metadaten, die diesem Schlüssel zugeordnet werden sollen. Metadaten der zweiten Ebene werden nicht verwendet. Dieses Argument sollte daher in der Regel als NULL angegeben werden.

Rückgabewert

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

Hinweise

Codebeispiel

ComPtr<IDataModelManager> spManager; /* get the data model manager */
ComPtr<IKeyStore> spMetadata;        /* get or create a metadata store */

ComPtr<IModelObject> sp16;
VARIANT vt16;
vt16.vt = VT_UI4;
vt16.ulVal = 16;
if (SUCCEEDED(spManager->CreateIntrinsicObject(ObjectIntrinsic, &vt16, &sp16)))
{
    if (SUCCEEDED(spMetadata->SetKey(L"PreferredRadix", sp16.Get(), nullptr)))
    {
        // The 'PreferredRadix' key has been set to 16 (even if it did 
        // not exist).  If this metadata store is passed to something like
        // IStringDisplayableConcept::ToDisplayString, the conversion of numbers 
        // will happen in hexadecimal instead of the default radix.
    }
}

Anforderungen

Anforderung Wert
Header dbgmodel.h

Weitere Informationen

IKeyStore-Schnittstelle