Fungsi NetWkstaTransportEnum (lmwksta.h)

Artikel
08/24/2023

Fungsi NetWkstaTransportEnum menyediakan informasi tentang protokol transportasi yang dikelola oleh pengalih, yang merupakan perangkat lunak pada komputer klien yang menghasilkan permintaan file ke komputer server.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportEnum(
  [in]      LPTSTR  servername,
  [in]      DWORD   level,
  [out]     LPBYTE  *bufptr,
  [in]      DWORD   prefmaxlen,
  [out]     LPDWORD entriesread,
  [out]     LPDWORD totalentries,
  [in, out] LPDWORD resume_handle
);

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.

[in] level

Tingkat informasi yang diminta untuk data. Parameter ini bisa menjadi nilai berikut.

Nilai	Makna
0	Mengembalikan informasi protokol transportasi stasiun kerja. Parameter bufptr menunjuk ke array struktur WKSTA_TRANSPORT_INFO_0 .

[out] bufptr

Penunjuk ke buffer yang menerima data. Format data ini tergantung pada nilai parameter tingkat . Buffer ini dialokasikan oleh sistem dan harus dikosongkan menggunakan fungsi NetApiBufferFree . Perhatikan bahwa Anda harus membebaskan buffer meskipun fungsi gagal dengan ERROR_MORE_DATA atau NERR_BufTooSmall.

[in] prefmaxlen

Panjang maksimum data yang dikembalikan yang disukai, dalam byte. Jika Anda menentukan MAX_PREFERRED_LENGTH, fungsi mengalokasikan jumlah memori yang diperlukan untuk data. Jika Anda menentukan nilai lain dalam parameter ini, nilai tersebut dapat membatasi jumlah byte yang dikembalikan fungsi. Jika ukuran buffer tidak cukup untuk menahan semua entri, fungsi akan mengembalikan ERROR_MORE_DATA atau NERR_BufTooSmall. Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan dan Panjang Buffer Fungsi Manajemen Jaringan.

[out] entriesread

Penunjuk ke nilai yang menerima hitungan elemen yang benar-benar dijumlahkan.

[out] totalentries

Penunjuk ke nilai yang menerima jumlah total entri yang bisa dijumlahkan dari posisi resume saat ini. Perhatikan bahwa aplikasi harus mempertimbangkan nilai ini hanya sebagai petunjuk.

[in, out] resume_handle

Penunjuk ke nilai yang berisi handel resume yang digunakan untuk melanjutkan pencarian transportasi stasiun kerja yang ada. Handel harus nol pada panggilan pertama dan dibiarkan tidak berubah untuk panggilan berikutnya. Jika parameter resumehandle adalah penunjuk NULL , tidak ada handel resume yang disimpan.

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_MORE_DATA	Entri lainnya tersedia. Tentukan buffer yang cukup besar untuk menerima semua entri.
ERROR_INVALID_LEVEL	Parameter tingkat, yang menunjukkan tingkat informasi struktur data apa yang tersedia, tidak valid. Kesalahan ini dikembalikan jika parameter tingkat ditentukan sebagai nilai selain nol.
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid. Kesalahan ini dikembalikan jika parameter bufptr atau entriesread adalah penunjuk NULL .
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia untuk memproses permintaan.
ERROR_NOT_SUPPORTED	Permintaan tidak didukung. Kesalahan ini dikembalikan jika server jarak jauh ditentukan dalam parameter nama server , dan permintaan ini tidak didukung pada server jarak jauh.
NERR_BufTooSmall	Entri lainnya tersedia. Tentukan buffer yang cukup besar untuk menerima semua entri. Kode kesalahan ini didefinisikan dalam file header Lmerr.h .

Keterangan

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

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	lmwksta.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll