IDataModelManager2::CreateNoValue method (dbgmodel.h)

Metode CreateNoValue membuat objek "tanpa nilai", menkotaknya ke dalam IModelObject, dan mengembalikannya. Objek model yang dikembalikan memiliki semacam ObjectNoValue.

Objek "tanpa nilai" memiliki beberapa arti semantik:

  • (Tergantung pada bahasa), itu dapat dianggap setara semantik kekosongan, null, atau tidak terdefinisi
  • Metode GetValue pengakses properti apa pun yang mengembalikan keberhasilan dan objek "tanpa nilai" yang dihasilkan menunjukkan bahwa properti tertentu tidak memiliki nilai untuk instans yang diberikan dan harus diperlakukan seolah-olah properti tidak ada untuk instans tertentu.
  • Metode model data yang tidak secara semantik memiliki nilai pengembalian menggunakan ini sebagai sentinel untuk menunjukkan seperti itu (sebagai metode harus mengembalikan IModelObject yang valid).

Sintaks

HRESULT CreateNoValue(
  IModelObject **object
);

Parameter

object

Objek "tanpa nilai" yang baru dibuat/dikotak akan dikembalikan di sini.

Nilai kembali

Metode ini mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan.

Keterangan

Kode Sampel

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

ComPtr<IModelObject> spNoValue;
if (SUCCEEDED(spManager->CreateNoValue(&spNoValue)))
{
    // spNoValue contains a "no value" object.  This can be 
    // returned from IModelMethod::Call (an indication of no return value).  
    // It can be returned from a property accessor to indicate that the 
    // property has "no value" for the given instance.
}

Persyaratan

Persyaratan Nilai
Header dbgmodel.h

Lihat juga

Antarmuka IDataModelManager2