Fungsi UiaDisconnectProvider (uiautomationcoreapi.h)

Merilis semua referensi yang dimiliki penyedia tertentu ke objek Microsoft UI Automation.

Sintaks

HRESULT UiaDisconnectProvider(
  [in] IRawElementProviderSimple *pProvider
);

Parameter

[in] pProvider

Jenis: IRawElementProviderSimple*

Penyedia yang akan diputus sambungannya.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Penyedia harus memanggil fungsi ini untuk membersihkan sumber daya Automation UI yang terkait dengan elemen UI yang dihancurkan. DLL yang terkait dengan elemen UI dapat dibongkar dengan aman setelah fungsi kembali.

Setelah fungsi ini kembali, semua permintaan klien yang terkait dengan penyedia yang terputus menerima kode kesalahan UIA_E_ELEMENTNOTAVAILABLE .

Fungsi ini tidak dapat dipanggil sebagai respons terhadap panggilan ke fungsi SendMessage . Aplikasi tidak dapat melakukan panggilan Model Objek Komponen (COM) keluar sebagai respons terhadap panggilan ke SendMessage, dan melepaskan penyedia biasanya merupakan panggilan COM keluar. Fungsi UiaDisconnectProvider mengembalikan RPC_E_CANTCALLOUT_ININPUTSYNCCALL jika fungsi dipanggil sebagai respons terhadap panggilan SendMessage . Anda dapat menggunakan fungsi InSendMessageEx untuk menentukan apakah pesan tertentu sedang ditangani sebagai respons terhadap panggilan SendMessage .

Aplikasi yang memanggil UiaDisconnectProvider tidak boleh menanggapi pesan WM_GETOBJECT entrant ulang dengan mengembalikan pointer ke penyedia yang coba diputus. Jika aplikasi mencoba memutuskan sambungan penyedia, tetapi kemudian memanggil fungsi UiaReturnRawElementProvider dengan penyedia yang sama selama upaya pemutusan sambungan, penyedia mungkin tidak sepenuhnya terputus.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	uiautomationcoreapi.h
Pustaka	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Lihat juga

Fungsi untuk Penyedia

UiaDisconnectAllProviders