Fungsi NetRemoteComputerSupports (lmremutl.h)

Artikel
08/24/2023

Fungsi NetRemoteComputerSupports meminta pengalih untuk mengambil fitur opsional yang didukung sistem jarak jauh. Fitur termasuk Unicode, Panggilan Prosedur Jarak Jauh (RPC), dan dukungan Protokol Administrasi Jarak Jauh. Fungsi ini menetapkan koneksi jaringan jika tidak ada.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetRemoteComputerSupports(
  [in]  LPCWSTR UncServerName,
  [in]  DWORD   OptionsWanted,
  [out] LPDWORD OptionsSupported
);

Parameter

[in] UncServerName

Penunjuk ke string konstanta yang menentukan nama server jarak jauh yang akan dikueri. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] OptionsWanted

Menentukan nilai yang berisi sekumpulan bendera bit yang menunjukkan fitur yang diminati. Parameter ini harus setidaknya salah satu nilai berikut.

Nilai	Makna
SUPPORTS_REMOTE_ADMIN_PROTOCOL	Meminta dukungan Protokol Administrasi Jarak Jauh.
SUPPORTS_RPC	Meminta dukungan RPC.
SUPPORTS_SAM_PROTOCOL	Meminta dukungan Security Account Manager (SAM).
SUPPORTS_UNICODE	Meminta dukungan standar Unicode.
SUPPORTS_LOCAL	Meminta dukungan untuk tiga nilai pertama yang tercantum dalam tabel ini. Jika UNICODE ditentukan oleh aplikasi panggilan, minta empat fitur yang tercantum sebelumnya.

[out] OptionsSupported

Penunjuk ke nilai yang menerima sekumpulan bendera bit. Bendera menunjukkan fitur mana yang ditentukan oleh parameter OptionsWanted yang diimplementasikan pada komputer yang ditentukan oleh parameter UncServerName . (Semua bit lainnya diatur ke nol.)

Nilai parameter ini hanya valid ketika fungsi NetRemoteComputerSupports mengembalikan NERR_Success.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Parameter OptionsWanted atau parameter OptionsSupported adalah NULL; kedua parameter diperlukan.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia.

Keterangan

Tidak ada keanggotaan grup khusus yang diperlukan untuk berhasil menjalankan fungsi NetRemoteComputerSupports .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	lmremutl.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll

Lihat juga

NetServerGetInfo

Fungsi Manajemen Jaringan

Gambaran Umum Manajemen Jaringan

Fungsi Utilitas Jarak Jauh

Bagikan melalui