struttura WSK_PROVIDER_CHARACTERISTICS (wsk.h)

Articolo
02/27/2024

La struttura WSK_PROVIDER_CHARACTERISTICS specifica le caratteristiche del sottosistema WSK.

Sintassi

typedef struct _WSK_PROVIDER_CHARACTERISTICS {
  USHORT HighestVersion;
  USHORT LowestVersion;
} WSK_PROVIDER_CHARACTERISTICS, *PWSK_PROVIDER_CHARACTERISTICS;

Members

HighestVersion

La versione più recente di WSK Network Programming Interface (NPI) supportata dal sottosistema WSK.

LowestVersion

Versione più bassa del server dei criteri di rete WSK supportata dal sottosistema WSK.

Commenti

Quando una chiamata WskCaptureProviderNPI ha esito negativo con codice di stato STATUS_NOINTERFACE, l'applicazione WSK può usare una chiamata a WskQueryProviderCharacteristics per eseguire query sull'intervallo di versioni NPI WSK supportate dal sottosistema WSK. WskQueryProviderCharacteristics restituisce le informazioni sulla versione tramite la struttura WSK_PROVIDER_CHARACTERISTICS. Un'applicazione WSK può usare queste informazioni per determinare se il sottosistema WSK supporta una versione del server dei criteri di rete WSK compatibile con l'applicazione.

I numeri di versione principali e secondari contenuti nei membri HighestVersion e LowestVersion vengono codificati usando la macro MAKE_WSK_VERSION:

Version = MAKE_WSK_VERSION(Major,Minor);

I numeri di versione principale e secondaria possono essere estratti dai membri HighestVersion e LowestVersion usando le macro WSK_MAJOR_VERSION e WSK_MINOR_VERSION:

Major = WSK_MAJOR_VERSION(Version);
Minor = WSK_MINOR_VERSION(Version);

Se un'applicazione WSK determina che il sottosistema WSK supporta una versione del server dei criteri di rete WSK compatibile con l'applicazione, l'applicazione deve chiamare WskRegister e, tramite il membro Dispatch della struttura WSK_CLIENT_NPI a cui punta il parametro WskClientNpi , deve specificare la versione esatta dell'npI WSK che desidera utilizzare nel membro Version della struttura WSK_CLIENT_DISPATCH . L'applicazione WSK deve specificare i membri rimanenti della struttura WSK_CLIENT_DISPATCH in modo che siano conformi alla versione del server dei criteri di rete WSK specificato nel membro Version della struttura.

Per altre informazioni sul collegamento di un'applicazione WSK al sottosistema WSK, vedere Registrazione di un'applicazione kernel Winsock.