Metode IModelObject::SetKeyValue (dbgmodel.h)

Metode SetKeyValue adalah metode pertama yang akan dialihkan klien untuk mengatur nilai kunci. Metode ini tidak dapat digunakan untuk membuat kunci baru pada objek. Ini hanya akan mengatur nilai kunci yang ada. Perhatikan bahwa banyak kunci bersifat baca-saja (misalnya: kunci tersebut diimplementasikan oleh pengakses properti yang mengembalikan E_NOT_IMPL dari metode SetValue). Metode ini akan gagal ketika dipanggil pada kunci baca saja.

Sintaks

HRESULT SetKeyValue(
  PCWSTR       key,
  IModelObject *object
);

Parameter

key

Nama kunci yang akan ditetapkan nilainya.

object

Nilai kunci akan diatur ke objek yang terkandung dalam argumen ini.

Nilai kembali

Metode ini mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan.

Keterangan

Sampel Kode

ComPtr<IDataModelManager> spManager; /* get the data model manager */
ComPtr<IModelObject> spObject;       /* get an object with a key named SomeKey */

// Box (int)42:
VARIANT vtVal;
vtVal.vt = VT_I4;
vtVal.lVal = 42;

ComPtr<IModelObject> spNewObject;
if (SUCCEEDED(spManager->CreateIntrinsicObject(ObjectIntrinsic, &vtVal, &spNewObject)))
{
    // Set the value of "SomeKey" to our newly boxed 42:
    if (SUCCEEDED(spObject->SetKeyValue(L"SomeKey", spNewObject.Get()))
    {
        // The key value has been set!
    }
}

Persyaratan

Persyaratan	Nilai
Header	dbgmodel.h

Lihat juga

Antarmuka IModelObject