Fungsi CoInvalidateRemoteMachineBindings (combaseapi.h)

Artikel
02/24/2024

Memberi tahu manajer kontrol layanan untuk membersihkan handel pengikatan RPC yang di-cache untuk komputer yang ditentukan.

Hanya administrator yang dapat memanggil fungsi ini.

Sintaks

HRESULT CoInvalidateRemoteMachineBindings(
  [in] LPOLESTR pszMachineName
);

Parameter

[in] pszMachineName

Nama komputer yang handel pengikatannya harus dibersihkan, atau string kosong untuk menandakan bahwa semua handel dalam cache harus dibersihkan.

Nilai kembali

Fungsi ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Menunjukkan keberhasilan.
CO_S_MACHINENAMENOTFOUND	Menunjukkan bahwa nama komputer yang ditentukan tidak ditemukan atau bahwa cache handel pengikatan kosong, menunjukkan bahwa string kosong diteruskan alih-alih nama komputer tertentu.
E_ACCESSDENIED	Menunjukkan bahwa penelepon bukan administrator untuk komputer ini.
E_INVALIDARG	Menunjukkan bahwa nilai NULL diteruskan untuk pszMachineName.

Keterangan

Manajer Kontrol Layanan OLE digunakan oleh COM untuk mengirim permintaan aktivasi komponen ke komputer lain. Untuk melakukan ini, Manajer Kontrol Layanan OLE mempertahankan cache handel pengikatan RPC untuk mengirim permintaan aktivasi ke komputer, yang dikunci oleh nama komputer. Dalam keadaan normal, ini berfungsi dengan baik, tetapi dalam beberapa skenario, seperti farm Web dan situasi penyeimbangan beban, kemampuan untuk membersihkan cache handel tertentu ini mungkin diperlukan untuk memfasilitasi pengikatan ulang ke server fisik yang berbeda dengan nama yang sama. CoInvalidateRemoteMachineBindings digunakan untuk tujuan ini.

Manajer Kontrol Layanan OLE akan menghapus handel pengikatan yang tidak digunakan dari waktu ke waktu. Tidak perlu memanggil CoInvalidateRemoteMachineBindings untuk melakukan ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	combaseapi.h (termasuk Objbase.h)
Pustaka	Ole32.lib
DLL	Ole32.dll

Bagikan melalui