Metode IClientSecurity::CopyProxy (objidl.h)

Artikel
02/29/2024

Membuat salinan privat proksi untuk antarmuka yang ditentukan.

Sintaks

HRESULT CopyProxy(
  [in]  IUnknown *pProxy,
  [out] IUnknown **ppCopy
);

Parameter

[in] pProxy

Penunjuk ke antarmuka yang proksinya akan disalin. Parameter ini tidak boleh NULL.

[out] ppCopy

Penunjuk ke penunjuk antarmuka IUnknown yang menerima salinan proksi. Parameter ini tidak boleh NULL.

Nilai kembali

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.

Keterangan

CopyProxy dipanggil oleh klien untuk membuat salinan privat proksi untuk antarmuka yang ditentukan. Salinan proksi memiliki nilai default untuk informasi autentikasi. Informasi autentikasinya dapat diubah melalui panggilan ke IClientSecurity::SetBlanket tanpa memengaruhi klien lain dari proksi asli. Salinan memiliki satu referensi, dan pemanggil CopyProxy harus memastikan bahwa salinan proksi dibebaskan.

Antarmuka lokal, seperti IUnknown dan IClientSecurity, tidak dapat disalin. Anda tidak dapat menduplikasi manajer proksi menggunakan CopyProxy.

Salinan proksi yang sama memiliki hubungan khusus sehubungan dengan QueryInterface. Mengingat proksi, a, dari antarmuka IA dari objek jarak jauh, misalkan salinan dibuat, yang disebut b. Dalam hal ini, memanggil QueryInterface dari proksi b untuk IID_IA tidak akan mengambil antarmuka IA pada b, tetapi yang ada di proksi asli.

Perhatikan bahwa siapa pun dapat meminta proksi dan mengubah keamanan di dalamnya menggunakan SetBlanket. Namun, ketika Anda telah membuat salinan proksi, tidak ada yang bisa mendapatkan salinan kecuali Anda memberikannya kepada mereka. Hanya orang yang memiliki salinan yang dapat mengatur keamanan di dalamnya.

Fungsi pembantu CoCopyProxy merangkum panggilan QueryInterface untuk pointer ke IClientSecurity, panggilan ke CopyProxy dengan pointer IClientSecurity , dan rilis pointer IClientSecurity .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	objidl.h (termasuk ObjIdl.h)

Lihat juga

CoCopyProxy

IClientSecurity

Bagikan melalui