Fungsi WPUOpenCurrentThread (ws2spi.h)

Artikel
03/13/2024

Fungsi WPUOpenCurrentThread membuka handel ke utas saat ini yang dapat digunakan dengan fungsi yang tumpang tindih di penyedia layanan berlapis. Ini dimaksudkan untuk digunakan oleh penyedia layanan berlapis yang ingin memulai I/O yang tumpang tindih dari utas nonapplikasi.

Sintaks

int WPUOpenCurrentThread(
  [out] LPWSATHREADID lpThreadId,
  [out] LPINT         lpErrno
);

Parameter

[out] lpThreadId

Penunjuk ke struktur WSATHREADID yang kemudian dapat diteruskan ke fungsi yang tumpang tindih.

[out] lpErrno

Arahkan ke kode kesalahan.

Mengembalikan nilai

Jika tidak ada kesalahan yang terjadi, WPUOpenCurrentThread mengembalikan nol. Jika tidak, ia mengembalikan SOCKET_ERROR, dan kode kesalahan tertentu tersedia di lpErrno.

Kode kesalahan	Makna
WSANOTINITIALISED	Panggilan WSPStartup yang berhasil harus terjadi sebelum menggunakan fungsi ini.

Keterangan

Fungsi WPUOpenCurrentThread menyediakan penunjuk ke struktur WSATHREADID yang kemudian dapat diteruskan ke fungsi yang tumpang tindih seperti LPWSPSend atau LPWSPRecv. Penyedia layanan berlapis yang menggunakan utas privat di salah satu lapisan atas akan menggunakan WPUOpenCurrentThread untuk meneruskan penunjuk WSATHREADID ke lapisan bawah yang mengelola fungsi yang tumpang tindih.

Fungsi yang tumpang tindih seperti LPWSPSend dan LPWSPRecv kemudian dapat digunakan dengan cara yang sama seperti penyedia layanan reguler.

Setiap panggilan ke WPUOpenCurrentThread harus memiliki panggilan yang sesuai ke WPUCloseThread.

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	ws2spi.h

Lihat juga

WPUCloseThread

LPWSPRecv

LPWSPSend

Bagikan melalui