Fungsi HSPluginInitPlugin

Wi-Fi hotspot offloading penghentian catatan

Penting

Mulai windows 10, versi 1709, fitur Wi-Fi Hotspot Offloading tidak digunakan lagi dan tidak boleh digunakan. Sebagai gantinya, sebaiknya tulis aplikasi UWP dan gunakan Wi-Fi Hotspot Authentication API (Windows.Networking.NetworkOperators).

Untuk sampel kode dan info selengkapnya, lihat sampel autentikasi hotspot Wi-Fi.

Fungsi HSPluginInitPlugin diekspor oleh DLL plugin dan dipanggil untuk menginisialisasi plugin.

Sintaksis

DWORD HSPluginInitPlugin(
  _In_  HANDLE                hPluginContext,
  _In_  DWORD                 dwVerNumUsed,
  _In_  DWORD                 dwHostCapabilities,
  _In_  HS_DEVICE_IDENTITY    *pDeviceIdentity,
  _In_  HOTSPOT_HOST_HANDLERS *pHotspotHostHandlers,
  _Out_ HOTSPOT_PLUGIN_APIS   *pHotspotPluginAPIs,
  _Out_ HS_PLUGIN_PROFILE     *pPluginProfile
);

Parameter

hPluginContext [in]
Handel, disediakan oleh host, bahwa plugin diperlukan untuk menyimpan dan kemudian menggunakan ketika perlu membuat permintaan ke host dengan cara fungsi handler host.

dwVerNumUsed [in]
Nomor versi host saat ini.

dwHostCapabilities [in]
Nilai yang menentukan daftar kemampuan yang dapat disediakan host ke plugin. Nilai ini adalah kombinasi bitwise OR dari bendera kemampuan yang berlaku. Untuk informasi selengkapnya tentang bendera kemampuan, lihat konstanta HS_FLAG_CAPABILITY_\* di Wi-Fi Hotspot Offloading Constants.

Catatan Jika host tidak menyediakan semua kemampuan yang diperlukan oleh plugin, plugin tidak akan diinisialisasi.

*pDeviceIdentity [in]
Penunjuk ke struktur HS_DEVICE_IDENTITY yang berisi informasi tentang produsen dan model perangkat.

*pHotspotHostHandlers [in]
Penunjuk ke struktur HOTSPOT_HOST_HANDLERS yang berisi tabel fungsi handler host hotspot. Tabel ini berisi pointer ke fungsi yang dipanggil oleh plugin untuk berkomunikasi dengan host hotspot.

*pHotspotPluginAPIs [out]
Penunjuk ke struktur HOTSPOT_PLUGIN_APIS yang berisi tabel fungsi API plugin hotspot. Tabel ini dikembalikan oleh plugin dan berisi pointer ke fungsi yang dipanggil oleh host untuk berkomunikasi dengan plugin.

*pPluginProfile [out]
Pointer ke struktur HS_PLUGIN_PROFILE, dikembalikan oleh plugin, yang menyediakan informasi tentang plugin.

Komentar

Selama inisialisasi, host menyediakan hal berikut:

  • Handel konteks plugin
  • Nomor versi saat ini
  • Daftar kemampuan yang dapat disediakan host ke plugin
  • Penunjuk ke tabel fungsi handler host tempat plugin dapat berkomunikasi dengan host

Plugin mengembalikan penunjuk ke tabel fungsinya sendiri dan penunjuk ke struktur HS_PLUGIN_PROFILE.

Persyaratan

Versi

Windows 10 Mobile

Header

 Hotspotoffloadplugin.h (termasuk Hotspotoffloadplugin.h)

Lihat juga

Wi-Fi Hotspot Offloading Constants

HS_DEVICE_IDENTITY

HOTSPOT_HOST_HANDLERS

HOTSPOT_PLUGIN_APIS

HS_PLUGIN_PROFILE

  • Last updated on