Struktur COSERVERINFO (objidlbase.h)

Artikel
03/15/2023

Mengidentifikasi sumber daya komputer jarak jauh ke fungsi aktivasi.

Sintaks

typedef struct _COSERVERINFO {
  DWORD      dwReserved1;
  LPWSTR     pwszName;
  COAUTHINFO *pAuthInfo;
  DWORD      dwReserved2;
} COSERVERINFO;

Anggota

dwReserved1

Anggota ini dicadangkan dan harus 0.

pwszName

Nama komputer.

pAuthInfo

Penunjuk ke struktur COAUTHINFO untuk mengambil alih keamanan aktivasi default untuk aktivasi jarak jauh mesin. Jika tidak, atur ke NULL untuk menunjukkan bahwa nilai default harus digunakan. Untuk informasi lebih lanjut, lihat bagian Keterangan.

dwReserved2

Anggota ini dicadangkan dan harus 0.

Keterangan

Struktur COSERVERINFO digunakan terutama untuk mengidentifikasi sistem jarak jauh dalam fungsi pembuatan objek. Sumber daya komputer diberi nama menggunakan skema penamaan transportasi jaringan. Secara default, semua nama UNC ("\\server" atau "server") dan DNS ("domain.com", "example.microsoft.com", atau "135.5.33.19") diperbolehkan.

Jika pAuthInfo diatur ke NULL, Snego akan digunakan untuk menegosiasikan layanan autentikasi yang akan berfungsi antara klien dan server. Namun, struktur COAUTHINFOnon-NULL dapat ditentukan untuk pAuthInfo untuk memenuhi salah satu kebutuhan berikut:

Untuk menentukan identitas klien yang berbeda untuk aktivasi jarak jauh komputer. Identitas yang ditentukan akan digunakan untuk pemeriksaan izin peluncuran pada server daripada identitas klien nyata.
Untuk menentukan bahwa Kerberos, bukan NTLMSSP, digunakan untuk aktivasi jarak jauh mesin. Identitas klien nondefault mungkin atau mungkin tidak ditentukan.
Untuk meminta aktivasi yang tidak aman.
Untuk menentukan layanan autentikasi kepemilikan.

Jika pAuthInfo bukan NULL, nilai-nilai tersebut akan digunakan untuk menentukan pengaturan autentikasi untuk panggilan jarak jauh. Pengaturan ini akan diteruskan ke fungsi RpcBindingSetAuthInfoEx .

Jika parameter pAuthInfo adalah NULL, maka dwAuthnLevel dapat ditimpa oleh tingkat autentikasi yang ditetapkan oleh fungsi CoInitializeSecurity . Jika fungsi CoInitializeSecurity tidak dipanggil, maka tingkat autentikasi yang ditentukan di bawah kunci registri AppID digunakan, jika ada.

Dimulai dengan Windows XP dengan Paket Layanan 2 (SP2), dwAuthnLevel adalah maksimum RPC_C_AUTHN_LEVEL_CONNECT dan tingkat autentikasi seluruh proses dari proses klien yang mengeluarkan permintaan aktivasi. Untuk versi sistem operasi yang lebih lama, ini RPC_C_AUTHN_LEVEL_CONNECT.

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]
Header	objidlbase.h (termasuk Objidl.h)