GetKeyValue メソッドは、メタデータ ストア内の特定のキーの値を検索するためにクライアントが移動する最初のメソッドです。 キー引数で指定されたキーがストア (または親ストア) 内に存在する場合は、そのキーの値と、それに関連付けられているメタデータが返されます。 キーの値がプロパティ アクセサー (IModelObjectにボックス化された IModelPropertyAccessor) の場合、プロパティ アクセサーの GetValue メソッドは、GetKeyValue と返されたプロパティの基になる値によって自動的に呼び出されます。
構文
HRESULT GetKeyValue(
PCWSTR key,
_COM_Errorptr_opt_ IModelObject **object,
IKeyStore **metadata
);
パラメーター
key
値を返すキーの名前。
object
キーの値がここに返されます。 キーの値がプロパティ アクセサーの場合、GetValue メソッドはプロパティ アクセサーで呼び出され、基になる値がここに返されます。
metadata
キーに関連付けられているメタデータは、必要に応じてここで返されます。 第 2 レベルのメタデータには現在使用されません。 したがって、通常、この引数は null として指定する必要があります。
戻り値
このメソッドは、成功または失敗を示す HRESULT を返します。
備考
コード サンプル
ComPtr<IKeyStore> spMetadata; /* get a metadata store */
ComPtr<IModelObject> spRadix;
if (SUCCEEDED(spMetadata->GetKeyValue(L"PreferredRadix", &spRadix, nullptr)))
{
// spRadix has the preferred display radix. Use GetIntrinsicValueAs to unbox.
}
必要条件
要件 | 価値 |
---|---|
ヘッダー | dbgmodel.h |
関連項目
IKeyStore インターフェイス の