IKeyStore::SetKey-Methode (dbgmodel.h)
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 |