Metode IKeyStore::SetKeyValue (dbgmodel.h)
Metode SetKeyValue dianalogikan dengan metode SetKeyValue pada IModelObject. Metode ini tidak mampu membuat kunci baru dalam penyimpanan metadata. Jika ada kunci yang ada seperti yang ditunjukkan oleh argumen kunci, nilainya akan diatur seperti yang ditunjukkan. Jika kuncinya adalah aksesor properti, metode SetValue akan dipanggil pada pengaktor properti untuk mengatur nilai yang mendasar. Perhatikan bahwa metadata biasanya statis setelah dibuat. Penggunaan metode ini pada penyimpanan kunci metadata harus jarang.
Sintaks
HRESULT SetKeyValue(
PCWSTR key,
IModelObject *object
);
Parameter
key
Nama kunci yang akan ditetapkan nilainya.
object
Nilai yang akan ditetapkan ke kunci. Jika nilai kunci saat ini adalah pengaktor properti, metode SetValue akan dipanggil pada aksesor properti untuk mengatur nilai yang mendasar.
Mengembalikan nilai
Metode ini mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan.
Keterangan
Sampel Kode
ComPtr<IKeyStore> spMetadata; /* get a metadata store */
ComPtr<IModelObject> spValue; /* get a value to set */
// This never creates a key. Most callers should prefer SetKey
if (SUCCEEDED(spMetadata->SetKeyValue(L"KnownExistingKey", spValue.Get()))
{
// The key's value was successfully set.
}
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | dbgmodel.h |