Metode IModelObject::SetKey (dbgmodel.h)

Metode SetKey adalah metode yang akan diaktifkan klien untuk membuat kunci pada objek (dan berpotensi mengaitkan metadata dengan kunci yang dibuat). Jika objek tertentu sudah memiliki kunci dengan nama yang diberikan, salah satu dari dua perilaku akan terjadi. Jika kunci ada pada instans yang diberikan oleh ini, nilai kunci tersebut akan diganti seolah-olah kunci asli tidak ada. Jika, di sisi lain, kunci berada dalam rantai model data induk instans yang diberikan oleh ini, kunci baru dengan nama yang diberikan akan dibuat pada instans yang diberikan oleh ini. Hal ini akan, berlaku, menyebabkan objek memiliki dua kunci dengan nama yang sama (mirip dengan kelas turunan yang membayangi anggota dengan nama yang sama dengan kelas dasar).

Sintaks

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

Parameter

key

Nama kunci yang akan ditetapkan nilainya.

object

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

metadata

Metadata opsional yang akan dikaitkan dengan kunci yang baru diatur.

Nilai kembali

Metode ini mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan.

Keterangan

Sampel Kode

ComPtr<IDataModelManager> spManager; /* get the data model manager */

// Create a new object with a property called "Test" with a value of 42.
ComPtr<IModelObject> spNewObject;
if (SUCCEEDED(spManager->CreateSyntheticObject(nullptr, &spNewObject)))
{
    VARIANT vtVal;
    vtVal.vt = VT_I4;
    vtVal.lVal = 42;

    ComPtr<IModelObject> sp42;
    if (SUCCEEDED(spManager->CreateIntrinsicObject(ObjectIntrinsic, &vtVal, &sp42)))
    {
        if (SUCCEEDED(spNewObject->SetKey(L"Test", sp42.Get(), nullptr)))
        {
            // We have placed a static "42" on the new object under the key "Test"
        }
    }
}

Persyaratan

Persyaratan	Nilai
Header	dbgmodel.h

Lihat juga

Antarmuka IModelObject