IModelObject::GetKeyValue メソッド (dbgmodel.h)
GetKeyValue メソッドは、指定されたキーの値 (および関連付けられているメタデータ) を名前で取得するためにクライアントが最初に設定するメソッドです。 キーがプロパティ アクセサーである場合(つまり、ボックス化された IModelPropertyAccessor である IModelObject の値)、GetKeyValue メソッドは、実際の値を取得するために、プロパティ アクセサーの GetValue メソッドを自動的に呼び出します。
構文
HRESULT GetKeyValue(
PCWSTR key,
_COM_Errorptr_opt_ IModelObject **object,
IKeyStore **metadata
);
パラメーター
key
値を取得するキーの名前。
object
キーの値は、この引数で返されます。 エラーの場合、メソッドから失敗した HRESULT が返される場合でも、この引数で拡張エラー情報が渡されることがあります。
metadata
このキーに関連付けられているメタデータ ストアは、必要に応じてこの引数で返されます。
戻り値
このメソッドは、成功または失敗を示す HRESULT を返します。 戻り値E_BOUNDS (または場合によってはE_NOT_SET) は、キーが見つからなかったことを示します。
注釈
コード サンプル
ComPtr<IModelObject> spProcess; /* get a process object */
ComPtr<IModelObject> spProcId;
if (SUCCEEDED(spProcess->GetKeyValue(L"Id", &spProcId, nullptr)))
{
// spProcId has a boxed process id. Use GetIntrinsicValueAs to unbox it.
}
要件
要件 | 値 |
---|---|
Header | dbgmodel.h |