Fungsi Netbios (nb30.h)

[Netbios tidak didukung pada Windows Vista, Windows Server 2008, dan versi sistem operasi berikutnya]

Fungsi Netbios menginterpretasikan dan menjalankan blok kontrol jaringan (NCB) yang ditentukan.

Fungsi Netbios disediakan terutama untuk aplikasi yang ditulis untuk antarmuka NetBIOS dan perlu di-port ke Windows. Aplikasi yang tidak memerlukan kompatibilitas dengan NetBIOS harus menggunakan antarmuka lain, seperti Soket Windows, mailslots, pipa bernama, RPC, atau COM terdistribusi untuk menyelesaikan tugas yang mirip dengan yang didukung oleh NetBIOS. Antarmuka lain ini lebih fleksibel dan portabel.

Sintaks

UCHAR Netbios(
  PNCB pncb
);

Parameter

pncb

Penunjuk ke struktur NCB yang menjelaskan blok kontrol jaringan.

Nilai kembali

Untuk permintaan sinkron, nilai yang dikembalikan adalah kode pengembalian dalam struktur NCB . Nilai tersebut juga dikembalikan dalam anggota ncb_retcode struktur NCB .

Untuk permintaan asinkron, ada kemungkinan berikut:

• Jika perintah asinkron telah selesai ketika Netbios kembali ke pemanggilnya, nilai yang dikembalikan adalah kode pengembalian dari struktur NCB, seolah-olah itu adalah struktur NCB yang sinkron.
• Jika perintah asinkron masih tertunda saat Netbios kembali ke pemanggilnya, nilai yang dikembalikan adalah nol.

Jika alamat yang ditentukan oleh parameter pncb tidak valid, nilai yang dikembalikan NRC_BADNCB.

Jika panjang buffer yang ditentukan dalam anggota ncb_length struktur NCB salah, atau jika buffer yang ditentukan oleh anggota ncb_retcode dilindungi dari operasi tulis, nilai yang dikembalikan NRC_BUFLEN.

Keterangan

Ketika blok kontrol jaringan asinkron selesai dan anggota ncb_post bukan nol, rutinitas yang ditentukan dalam ncb_post dipanggil dengan satu parameter. Parameter ini berisi penunjuk ke struktur NCB , blok kontrol jaringan.

Struktur NCB berisi handel peristiwa (anggota ncb_event ). Sistem mengatur peristiwa ke status tidak bertanda ketika perintah NetBIOS asinkron diterima, dan mengatur peristiwa ke status tersinyal ketika perintah NetBIOS asinkron selesai. Hanya peristiwa reset manual yang harus digunakan untuk sinkronisasi. Peristiwa tertentu tidak boleh dikaitkan dengan lebih dari satu perintah NetBIOS asinkron aktif.

Menggunakan ncb_event untuk mengirimkan permintaan asinkron memerlukan lebih sedikit sumber daya sistem daripada menggunakan ncb_post. Selain itu, ketika ncb_event bukan nol, permintaan yang tertunda dibatalkan jika utas berakhir sebelum permintaan diproses. Ini tidak berlaku untuk permintaan yang dikirim dengan menggunakan ncb_post.

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	nb30.h
Pustaka	Netapi32.lib
DLL	Netapi32.dll

Lihat juga

NCB