RxAssociateContextWithMid, fonction (midatlax.h)

Article
02/26/2024

RxAssociateContextWithMid associe le contexte opaque fourni à un MULTIPLEX ID (MID) disponible à partir d’un MID_ATLAS.

Syntaxe

NTSTATUS RxAssociateContextWithMid(
  PRX_MID_ATLAS MidAtlas,
  PVOID         Context,
  PUSHORT       NewMid
);

Paramètres

MidAtlas

Pointeur vers la structure de données MID_ATLAS.

Context

Pointeur vers le contexte.

NewMid

Pointeur vers l’ID multiplex à associer au contexte.

Valeur retournée

RxAssociateContextWithMid retourne STATUS_SUCCESS en cas de réussite ou l’une des valeurs d’erreur suivantes :

Code de retour	Description
STATUS_INSUFFICIENT_RESOURCES	Cette erreur est retournée lorsqu’il n’était pas possible d’allouer suffisamment de mémoire pour la nouvelle structure de données MID_MAP.
STATUS_UNSUCCESSFUL	Cette erreur est retournée pour plusieurs cas, notamment lorsque le nombre de MID déjà utilisés est supérieur au nombre maximal de MID définis lors de la création de la structure MID_ATLAS.

Remarques

RDBSS définit un MULTIPLEX ID (MID), une valeur 16 bits, qui peut être utilisée par le client réseau (mini-redirecteur) et le serveur pour faire la distinction entre les requêtes actives simultanées sur n’importe quelle connexion. Un MID est un composant d’une structure de données MID_ATLAS allouée en appelant RxCreateMidAtlas. Une structure de données MID_MAP est allouée et utilisée pour le mappage des MID aux structures de données RX_CONTEXT. RxAssociateContextWithMid alloue de la mémoire de pool non paginée lors de la création d’une structure de données MID_MAP.

Le paramètre pContext peut être n’importe quel contexte opaque, mais il s’agit généralement d’un RX_CONTEXT.