Interfaccia di programmazione di rete

Un'interfaccia di programmazione di rete, o NPI, definisce l'interfaccia tra i moduli di rete che possono essere collegati tra loro. Un modulo client registrato come client di un determinato server dei criteri di rete può essere collegato solo ai moduli provider registrati come provider dello stesso server dei criteri di rete. Analogamente, un modulo provider registrato come provider di un determinato server dei criteri di rete può essere collegato solo ai moduli client registrati come client dello stesso server dei criteri di rete.

Ogni NPI definisce gli elementi seguenti:

• Un identificatore NPI che identifica in modo univoco l'NPI. Un modulo di rete specifica un identificatore NPI per indicare il particolare NPI che supporta quando il modulo di rete si registra presso il Registratore del Modulo di Rete (NMR). Un modulo di rete può supportare più interfacce di protocollo di rete (NPIs) registrandosi più volte con l'NMR, una volta per ogni interfaccia di protocollo di rete che supporta. Il NMR avvierà il collegamento di un modulo client a un modulo provider solo se entrambi supportano lo stesso NPI.

• Struttura facoltativa delle caratteristiche client che specifica le caratteristiche specifiche del NPI di ciascun modulo client. Tali caratteristiche specifiche del server dei criteri di rete possono includere elementi quali la versione (o le versioni) del server dei criteri di rete supportata da un modulo client o la famiglia di indirizzi o il protocollo richiesto da un modulo client. Un modulo provider può usare le informazioni contenute nella struttura delle caratteristiche client di un modulo client per determinare se si connetterà al modulo client. Se un NPI non definisce alcuna caratteristica specifica del cliente per l'NPI, allora questa struttura non è necessaria.

• Struttura facoltativa delle caratteristiche del provider che specifica le caratteristiche NPI-specifiche di ciascun modulo del provider. Tali caratteristiche specifiche dell'NPI possono includere elementi come la versione (o le versioni) dell'NPI supportata da un modulo del provider, o quali famiglie di indirizzi o protocolli sono supportati da un modulo del provider. Un modulo client può usare le informazioni contenute nella struttura delle caratteristiche client di un modulo provider per determinare se si connetterà al modulo del provider. Se un NPI non definisce alcuna caratteristica del fornitore specifica per l'NPI, questa struttura non è necessaria.

• Zero o più funzioni di callback del modulo client. Dopo che un modulo provider è stato collegato correttamente a un modulo client, il modulo del provider può accedere alla funzionalità del modulo client chiamando le funzioni di callback del modulo client.

• Una o più funzioni del modulo del provider. Dopo che un modulo client è stato collegato correttamente a un modulo provider, il modulo client può accedere alla funzionalità del modulo provider chiamando le funzioni del modulo del provider.

• Una struttura della tabella di dispatch del client che contiene puntatori a funzioni di ognuna delle funzioni di callback del modulo client. Se un NPI non definisce alcuna funzione di callback del modulo client, allora questa struttura non è necessaria.

• Struttura della tabella dispatch del provider che contiene puntatori di funzione a ognuna delle funzioni del modulo del provider.

Un modulo client che supporta un determinato NPI utilizza gli elementi definiti dal NPI per implementare il lato client dell'interfaccia. Analogamente, un modulo provider che supporta un particolare NPI utilizza gli elementi definiti dall'NPI per implementare il lato provider dell'interfaccia.

Tutti gli elementi definiti da un NPI sono opachi per l'NMR, ad eccezione dell'identificatore NPI. NmR usa l'identificatore NPI per determinare quali moduli client devono essere collegati ai moduli del provider.