IDynamicKeyProviderConcept::GetKey 方法 (dbgmodel.h)
動態密鑰提供者上的 GetKey 方法主要是 IModelObject 上的 GetKey 方法覆寫。 動態金鑰提供者預期會傳回索引鍵的值,以及與該索引鍵相關聯的任何元數據。 如果機碼不存在 (,但未發生其他錯誤) ,提供者必須在 hasKey 參數中傳回 false,並成功S_OK。 無法呼叫此呼叫會被視為無法擷取密鑰,並明確停止透過父模型鏈結搜尋密鑰。 在 hasKey 中傳回 false,成功將會繼續搜尋密鑰。
請注意,GetKey 將 Boxed 屬性存取子當做索引鍵傳回完全合法。 這與 IModelObject 上傳回屬性存取子的 GetKey 方法語意相同。
語法
HRESULT GetKey(
IModelObject *contextObject,
PCWSTR key,
IModelObject **keyValue,
IKeyStore **metadata,
bool *hasKey
);
參數
contextObject
實例物件 (這個指標) 取得索引鍵。
key
正在擷取之金鑰的名稱。
keyValue
此處會傳回動態提供者所決定的索引鍵值。 如果在擷取中發生錯誤,並傳回無效的 HRESULT,這可能會傳回延伸的錯誤資訊。 GetKey 方法的實作在 IModelPropertyAccessor) (傳回屬性存取子是合法的。
metadata
您可以在這裏選擇性地傳回任何與索引鍵相關聯的元數據。
hasKey
指出動態提供者是否有金鑰。 如果提供者沒有金鑰,則必須在此傳回 false 並成功。
傳回值
這個方法會傳回 HRESULT,表示成功或失敗。
規格需求
需求 | 值 |
---|---|
標頭 | dbgmodel.h |