IModelObject::SetKey 方法 (dbgmodel.h)
SetKey 方法是用戶端將轉換成的方法,以便在物件上建立索引鍵(並可能將元數據與建立的密鑰產生關聯)。 如果指定的物件已經有具有指定名稱的索引鍵,則會發生兩種行為之一。 如果索引鍵位於這個 指定的實例上,則會取代該索引鍵的值,就像原始索引鍵不存在一樣。 另一方面,如果索引鍵位於這個所指定實例的父數據模型鏈結中,則會在此指定的實例上建立具有指定名稱的新索引鍵。 實際上,這會導致物件有兩個相同名稱的索引鍵(類似於陰影與基類相同名稱成員的衍生類別)。
語法
HRESULT SetKey(
PCWSTR key,
IModelObject *object,
IKeyStore *metadata
);
參數
key
要為其設定值的索引鍵名稱。
object
索引鍵的值將會設定為此自變數中包含的物件。
metadata
要與新設定索引鍵相關聯的選擇性元數據。
傳回值
此方法會傳回表示成功或失敗的 HRESULT。
言論
程式代碼範例
ComPtr<IDataModelManager> spManager; /* get the data model manager */
// Create a new object with a property called "Test" with a value of 42.
ComPtr<IModelObject> spNewObject;
if (SUCCEEDED(spManager->CreateSyntheticObject(nullptr, &spNewObject)))
{
VARIANT vtVal;
vtVal.vt = VT_I4;
vtVal.lVal = 42;
ComPtr<IModelObject> sp42;
if (SUCCEEDED(spManager->CreateIntrinsicObject(ObjectIntrinsic, &vtVal, &sp42)))
{
if (SUCCEEDED(spNewObject->SetKey(L"Test", sp42.Get(), nullptr)))
{
// We have placed a static "42" on the new object under the key "Test"
}
}
}
要求
要求 | 價值 |
---|---|
標頭 | dbgmodel.h |