winrt::try_create_instance templat fungsi (C++/WinRT)

  • Artikel

Templat fungsi yang membuat satu objek yang tidak diinisialisasi dari kelas yang terkait dengan CLSID tertentu, dan mengembalikannya sebagai winrt::com_ptr atau com_ptr kosong jika tidak berhasil.

Sintaks

template <typename Interface>
winrt::com_ptr<Interface> try_create_instance(guid const& clsid,
    uint32_t context = 0x1 /*CLSCTX_INPROC_SERVER*/,
    void* outer = nullptr);

Parameter templat

typename Interface Jenis penunjuk antarmuka yang akan dikueri pada objek yang baru dibuat.

Parameter

clsid CLSID yang terkait dengan data dan kode yang akan digunakan untuk membuat objek.

context Konteks di mana kode yang mengelola objek yang baru dibuat akan berjalan. Nilai diambil dari enumerasi CLSCTX.

outer Jika nullptr, menunjukkan bahwa objek tidak dibuat sebagai bagian dari agregat. Jika tidak nullptr, pointer ke antarmuka IUnknown objek agregat ( IUnknown pengontrol).

Mengembalikan nilai

Winrt::com_ptr objek yang baru dibuat atau com_ptr kosong jika tidak berhasil.

Persyaratan

SDK minimum yang didukung: Windows SDK versi 10.0.17134.0 (Windows 10, versi 1803)

Namespace: winrt

Header: %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (disertakan secara default)

Lihat juga