IKeyStore::SetKey method (dbgmodel.h)

The SetKey method is analogous to the SetKey method on IModelObject. It is the only method which is capable of creating a key and associating metadata with it within the key store.

Syntax

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

Parameters

key

The name of the key to create or set a value for.

object

The value of the key.

metadata

Optional metadata to be associated with this key. There is no present use for second level metadata. This argument should therefore typically be specified as null.

Return value

This method returns HRESULT that indicates success or failure.

Remarks

Code Sample

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.
    }
}

Requirements

Requirement Value
Header dbgmodel.h

See also

IKeyStore interface