structure NPI_CLIENT_CHARACTERISTICS (netioddk.h)
La structure NPI_CLIENT_CHARACTERISTICS définit les caractéristiques d’un module client.
Syntaxe
typedef struct _NPI_CLIENT_CHARACTERISTICS {
USHORT Version;
USHORT Length;
PNPI_CLIENT_ATTACH_PROVIDER_FN ClientAttachProvider;
PNPI_CLIENT_DETACH_PROVIDER_FN ClientDetachProvider;
PNPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN ClientCleanupBindingContext;
NPI_REGISTRATION_INSTANCE ClientRegistrationInstance;
} NPI_CLIENT_CHARACTERISTICS;
Membres
Version
Version de la NMR auprès de laquelle le client s’inscrit. Un module client doit définir ce membre sur zéro.
Length
Taille, en octets, de la structure NPI_CLIENT_CHARACTERISTICS.
ClientAttachProvider
Pointeur vers la fonction de rappel client ClientAttachProvider.
ClientDetachProvider
Pointeur vers la fonction de rappel ClientDetachProvider du module client.
ClientCleanupBindingContext
Pointeur vers le module client Fonction de rappel ClientCleanupBindingContext. Si le module client n’alloue pas dynamiquement la mémoire à son contexte de liaison et qu’aucun autre nettoyage de son contexte de liaison n’est nécessaire, le module client n’a pas besoin d’implémenter une Fonction de rappel ClientCleanupBindingContext. Si le module client n’implémente pas un Fonction de rappel ClientCleanupBindingContext, ce membre doit être défini sur NULL.
ClientRegistrationInstance
Un NPI_REGISTRATION_INSTANCE structure qui spécifie l’identité du module client et le NPI pour lequel il s’inscrit.
Remarques
Un module client transmet un pointeur vers une structure NPI_CLIENT_CHARACTERISTICS vers la fonction NmrRegisterClient lorsqu’elle s’inscrit auprès de la NMR.
Un module client doit s’assurer que cette structure reste valide et résident en mémoire tant que le module client est inscrit auprès de la NMR.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| d’en-tête | netioddk.h (include Wsk.h) |