structure NPI_CLIENT_CHARACTERISTICS (netioddk.h)

  • Article

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 RMN 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 ClientAttachProvider du module client.

ClientDetachProvider

Pointeur vers la fonction de rappel ClientDetachProvider du module client.

ClientCleanupBindingContext

Pointeur vers le module clientFonction de rappel ClientCleanupBindingContext. Si le module client n’alloue pas dynamiquement la mémoire pour son contexte de liaison et qu’aucun autre nettoyage de son contexte de liaison n’est requis, le module client n’a pas besoin d’implémenter unFonction de rappel ClientCleanupBindingContext. Si le module client n’implémente pas unFonction de rappel ClientCleanupBindingContext, ce membre doit être défini sur NULL.

ClientRegistrationInstance

An 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’il s’inscrit auprès de la RMN.

Un module client doit s’assurer que cette structure reste valide et qu’elle réside dans la mémoire tant que le module client est inscrit auprès de la RMN.

Configuration requise

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

Voir aussi

ClientAttachProvider

ClientCleanupBindingContext

ClientDetachProvider

NPI_REGISTRATION_INSTANCE

NmrRegisterClient