NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN fonction de rappel (netioddk.h)

La fonction de rappel ProviderCleanupBindingContext d’un module fournisseur effectue tout nettoyage et désallocation nécessaires du contexte de liaison du module fournisseur une fois que le module fournisseur et un module client se sont détachés l’un de l’autre.

Syntaxe

NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN NpiProviderCleanupBindingContextFn;

void NpiProviderCleanupBindingContextFn(
  [in] PVOID ProviderBindingContext
)
{...}

Paramètres

[in] ProviderBindingContext

Pointeur vers le contexte du module fournisseur pour la liaison entre le module fournisseur et le module client duquel il s’est détaché. La fonction de rappel ProviderAttachClient du module fournisseur retourne ce pointeur vers la NMR lorsqu’elle s’attache au module client.

Valeur de retour

None

Remarques

La NMR appelle la fonction de rappel ProviderCleanupBindingContext d’un module fournisseur après que le fournisseur et un module client se sont détachés l’un de l’autre.

La fonction de rappel ProviderCleanupBindingContext d’un module fournisseur doit effectuer tout nettoyage nécessaire des données contenues dans la structure de contexte de liaison du module fournisseur. Il doit ensuite libérer la mémoire de la structure de contexte de liaison si le module fournisseur a alloué dynamiquement la mémoire pour la structure.

Si le module fournisseur n’alloue pas dynamiquement la mémoire pour son contexte de liaison et qu’aucun autre nettoyage de son contexte de liaison n’est nécessaire, le module fournisseur n’a pas besoin d’implémenter une fonction de rappel ProviderCleanupBindingContext . Si le module fournisseur n’implémente pas de fonction de rappel ProviderCleanupBindingContext , il doit définir le membre ProviderCleanupBindingContext du NPI_PROVIDER_CHARACTERISTICS structure à NULL quand elle appelle la fonction NmrRegisterProvider pour s’inscrire auprès de la NMR.

La RMN appelle la fonction de rappel ProviderCleanupBindingContext d’un module fournisseur à n’importe quel irQL <= DISPATCH_LEVEL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Windows
En-tête	netioddk.h (inclure Wsk.h)
IRQL	<= DISPATCH_LEVEL

Voir aussi

ClientDetachProvider

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient

ProviderDetachClient