IKeyStore::Metode GetKeyValue (dbgmodel.h)

  • Artikel

Metode GetKeyValue adalah metode pertama yang akan dituju klien untuk menemukan nilai kunci tertentu dalam penyimpanan metadata. Jika kunci yang ditentukan oleh argumen kunci ada di dalam penyimpanan (atau penyimpanan induk), nilai kunci tersebut dan metadata apa pun yang terkait dengannya akan dikembalikan. Jika nilai kunci adalah pengakses properti ( IModelPropertyAccessor yang dikotak ke dalam IModelObject), metode GetValue dari pengakses properti akan secara otomatis dipanggil oleh GetKeyValue dan nilai mendasar properti yang dikembalikan.

Sintaks

HRESULT GetKeyValue(
  PCWSTR                          key,
  _COM_Errorptr_opt_ IModelObject **object,
  IKeyStore                       **metadata
);

Parameter

key

Nama kunci untuk mengembalikan nilai.

object

Nilai kunci akan dikembalikan di sini. Jika nilai kunci adalah aksesor properti, metode GetValue akan dipanggil pada aksesor properti dan nilai yang mendasar akan dikembalikan di sini..

metadata

Metadata apa pun yang terkait dengan kunci secara opsional dikembalikan di sini. Tidak ada penggunaan saat ini untuk metadata tingkat kedua. Argumen ini biasanya harus ditentukan sebagai null.

Mengembalikan nilai

Metode ini mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan.

Keterangan

Sampel Kode

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.
}

Persyaratan

Persyaratan Nilai
Header dbgmodel.h

Lihat juga

Antarmuka IKeyStore