Funzione HSPluginInitPlugin

Wi-Fi Nota di deprecazione dell'offload hotspot

Importante

A partire da Windows 10 versione 1709, la funzionalità di offload hotspot Wi-Fi è deprecata e non deve essere usata. Ti consigliamo invece di scrivere un'app UWP e di usare l'API di autenticazione hotspot Wi-Fi (Windows.Networking.NetworkOperators).

Per un esempio di codice e altre informazioni, vedere l'esempio di autenticazione hotspot Wi-Fi.

La funzione HSPluginInitPlugin viene esportata dalla DLL del plug-in e viene chiamata per inizializzare il plug-in.

Sintassi

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

Parametri

hPluginContext [in]
Handle, fornito dall'host, che il plug-in è necessario per salvare e quindi usare quando deve effettuare una richiesta all'host tramite le funzioni del gestore host.

dwVerNumUsed [in]
Numero di versione corrente dell'host.

dwHostCapabilities [in]
Valore che specifica l'elenco di funzionalità che l'host può fornire al plug-in. Questo valore è la combinazione OR bit per bit dei flag di funzionalità applicabili. Per altre informazioni sui flag di funzionalità, vedere le costanti HS_FLAG_CAPABILITY_\* in Wi-Fi Costanti di offload hotspot.

Nota Se l'host non fornisce tutte le funzionalità richieste dal plug-in, il plug-in non verrà inizializzato.

*pDeviceIdentity [in]
Puntatore a una struttura HS_DEVICE_IDENTITY che contiene informazioni sul produttore e sul modello del dispositivo.

*pHotspotHostHandlers [in]
Puntatore a una struttura HOTSPOT_HOST_HANDLERS che contiene la tabella delle funzioni dei gestori host hotspot. Questa tabella contiene puntatori alle funzioni chiamate dal plug-in per comunicare con l'host hotspot.

*pHotspotPluginAPIs [out]
Puntatore alla struttura HOTSPOT_PLUGIN_APIS che contiene la tabella delle funzioni del plug-in hotspot. Questa tabella viene restituita dal plug-in e contiene puntatori alle funzioni chiamate dall'host per comunicare con il plug-in.

*pPluginProfile [out]
Puntatore a una struttura HS_PLUGIN_PROFILE, restituita dal plug-in, che fornisce informazioni sul plug-in.

Osservazioni

Durante l'inizializzazione, l'host fornisce quanto segue:

  • Handle di contesto del plug-in
  • Numero di versione corrente
  • Elenco di funzionalità che l'host può fornire al plug-in
  • Puntatore alla tabella delle funzioni del gestore host tramite cui il plug-in può comunicare con l'host

Il plug-in restituisce un puntatore alla propria tabella di funzioni e un puntatore alla relativa struttura HS_PLUGIN_PROFILE.

Fabbisogno

Versione

Windows 10 Mobile

Intestazione

Hotspotoffloadplugin.h (include Hotspotoffloadplugin.h)

Vedere anche

Wi-Fi costanti di offload hotspot

HS_DEVICE_IDENTITY

HOTSPOT_HOST_HANDLERS

HOTSPOT_PLUGIN_APIS

HS_PLUGIN_PROFILE