共用方式為


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

另請參閱

IDynamicKeyProviderConcept 介面