IModelKeyReference2::GetKey-Methode (dbgmodel.h)
Die GetKey-Methode für einen Schlüsselverweis verhält sich wie die GetKey-Methode auf IModelObject . Sie gibt den Wert des zugrunde liegenden Schlüssels und alle Metadaten zurück, die dem Schlüssel zugeordnet sind. Wenn der Wert des Schlüssels ein Eigenschaftsaccessor ist, wird der Eigenschaftsaccessor (IModelPropertyAccessor) zurückgegeben, der in ein IModelObject geschachtelt ist. Diese Methode ruft die zugrunde liegenden GetValue- oder SetValue-Methoden für den Eigenschaftenaccessor nicht auf.
Syntax
HRESULT GetKey(
_COM_Errorptr_opt_ IModelObject **object,
IKeyStore **metadata
);
Parameter
object
Der Wert des Schlüssels wird hier zurückgegeben.
metadata
Optionale Metadaten, die dem Schlüssel zugeordnet sind, werden hier zurückgegeben.
Rückgabewert
Diese Methode gibt HRESULT zurück, das den Erfolg oder Fehler angibt.
Hinweise
Codebeispiel
ComPtr<IModelObject> spObject; /* get an object */
ComPtr<IModelKeyReference> spKeyRef;
if (SUCCEEDED(spObject->GetKeyReference(L"Id", &spKeyRef, nullptr)))
{
ComPtr<IModelObject> spKey;
if (SUCCEEDED(spKeyRef->GetKey(&spKey, nullptr)))
{
// spKey contains the equivalent of spObject->GetKey(L"Id", &spKey, nullptr)
// This may be a property accessor since this was not a GetKeyValue.
// Check and fetch. Note that GetKeyValue would do this for you.
ModelObjectKind kind;
if (SUCCEEDED(spKey->GetKind(&kind)))
{
if (kind == ObjectPropertyAccessor)
{
VARIANT vtProp;
if (SUCCEEDED(spKey->GetIntrinsicValue(&vtProp)))
{
// We are guaranteed *in-process* that the IUnknown is
// an IModelPropertyAccessor via the ObjectPropertyAccessor
IModelPropertyAccessor *pProperty =
static_cast<IModelPropertyAccessor *>(vtProp.punkVal);
// In order to fetch, we need to know the context object and
// the key name. Fetch it from the key reference.
ComPtr<IModelObject> spContextObject;
if (SUCCEEDED(spKeyRef->GetContextObject(&spContextObject)))
{
BSTR keyName;
if (SUCCEEDED(spKeyRef->GetName(&keyName)))
{
ComPtr<IModelObject> spKeyValue;
if (SUCCEEDED(pProperty->GetValue(keyName,
spContextObject.Get(),
&spKeyValue)))
{
// spKeyValue contains the value of the "Id" key.
}
SysFreeString(keyName);
}
}
VariantFree(&vtProp);
}
}
else
{
// spKey contains the value of the "Id" key.
}
}
}
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |