Funktionen HSPluginInitPlugin

Wi-Fi Anteckning om utfasning av hotspotavlastning

Viktig

Från och med Windows 10 version 1709 är funktionen Wi-Fi Hotspot Offloading inaktuell och bör inte användas. I stället rekommenderar vi att du skriver en UWP-app och använder API:et Wi-Fi Hotspot Authentication (Windows.Networking.NetworkOperators).

Ett kodexempel och mer information finns i exemplet Wi-Fi hotspot-autentisering.

Funktionen HSPluginInitPlugin exporteras av plugin-DLL och anropas för att initiera plugin-programmet.

Syntax

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
);

Parametrar

hPluginContext [in]
Ett handtag, som tillhandahålls av värden, som plugin-programmet krävs för att spara och sedan använder när det behöver göra en begäran till värden via värdhanterarfunktionerna.

dwVerNumUsed [in]
Värdens aktuella versionsnummer.

dwHostCapabilities [in]
Värde som anger listan över funktioner som värden kan tillhandahålla plugin-programmet. Det här värdet är bitvis ELLER-kombinationen av tillämpliga kapacitetsflaggor. Mer information om funktionsflaggor finns i konstanterna HS_FLAG_CAPABILITY_\* i Wi-Fi Hotspot Offloading Constants.

Obs Om värden inte tillhandahåller alla funktioner som krävs av plugin-programmet initieras inte plugin-programmet.

*pDeviceIdentity [in]
Pekare till en HS_DEVICE_IDENTITY struktur som innehåller information om enhetstillverkaren och modellen.

*pHotspotHostHandlers [in]
Pekare till en HOTSPOT_HOST_HANDLERS struktur som innehåller funktionstabellen för värdhanterarhanteraren för hotspots. Den här tabellen innehåller pekare till funktioner som anropas av plugin-programmet för att kommunicera med hotspot-värden.

*pHotspotPluginAPIs [out]
Pekare till den HOTSPOT_PLUGIN_APIS struktur som innehåller funktionstabellen för API:er för plugin-program för hotspot. Den här tabellen returneras av plugin-programmet och innehåller pekare till funktioner som anropas av värden för att kommunicera med plugin-programmet.

*pPluginProfile [out]
Pekare till en HS_PLUGIN_PROFILE struktur, som returneras av plugin-programmet, som innehåller information om plugin-programmet.

Anmärkningar

Under initieringen tillhandahåller värden följande:

  • Kontextreferensen för plugin-programmet
  • Det aktuella versionsnumret
  • En lista över funktioner som värden kan tillhandahålla till plugin-programmet
  • En pekare till den värdhanterarfunktionstabell genom vilken plugin-programmet kan kommunicera med värden

Plugin-programmet returnerar en pekare till en egen funktionstabell och en pekare till dess HS_PLUGIN_PROFILE struktur.

Krav

Version

Windows 10 Mobile

Rubrik

Hotspotoffloadplugin.h (inkludera Hotspotoffloadplugin.h)

Se även

Wi-Fi Hotspot Offloading Constants

HS_DEVICE_IDENTITY

HOTSPOT_HOST_HANDLERS

HOTSPOT_PLUGIN_APIS

HS_PLUGIN_PROFILE