Fungsi NetWkstaTransportAdd (lmwksta.h)

Artikel
08/24/2023

[Fungsi ini sudah usang. Untuk mengubah setelan asali untuk protokol transportasi secara manual, gunakan kotak dialog Properti Sambungan Area Lokal di dalam folder Sambungan Jaringan dan Putar-Nomor .]

Tidak didukung.

Fungsi NetWkstaTransportAdd mengikat (atau menyambungkan) pengalih ke transportasi. Pengalih adalah perangkat lunak pada komputer klien yang menghasilkan permintaan file ke komputer server.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parameter

[in] servername

Penunjuk ke string yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

String ini harus dimulai dengan \.

[in] level

Menentukan tingkat informasi data. Parameter ini bisa menjadi nilai berikut.

Nilai	Makna
0	Menentukan informasi protokol transportasi stasiun kerja. Parameter buf menunjuk ke struktur WKSTA_TRANSPORT_INFO_0 .

[in] buf

Penunjuk ke buffer yang menentukan data. Format data ini tergantung pada nilai parameter tingkat . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan.

[out] parm_err

Penunjuk ke nilai yang menerima indeks parameter pertama yang menyebabkan kesalahan ERROR_INVALID_PARAMETER. Jika parameter ini NULL, indeks tidak dikembalikan pada kesalahan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

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

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pengguna tidak memiliki akses ke informasi yang diminta.
ERROR_INVALID_LEVEL	Parameter tingkat, yang menunjukkan tingkat informasi struktur data apa yang tersedia, tidak valid.
ERROR_INVALID_PARAMETER	Salah satu parameter fungsi tidak valid.

Keterangan

Hanya anggota grup lokal Administrator yang berhasil menjalankan fungsi NetWkstaTransportAdd .

Jika fungsi NetWkstaTransportAdd mengembalikan ERROR_INVALID_PARAMETER, Anda dapat menggunakan parameter parm_err untuk menunjukkan anggota struktur WKSTA_TRANSPORT_INFO_0 yang tidak valid. Tabel berikut ini mencantumkan nilai yang bisa dikembalikan dalam parameter parm_err dan anggota struktur terkait yang dalam kesalahan.

Nilai	Anggota
TRANSPORT_QUALITYOFSERVICE_PARMNUM	wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM	wkti0_transport_name

Persyaratan


Target Platform	Windows
Header	lmwksta.h (termasuk Lm.h, Lmwksta.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll

Bagikan melalui