RxAssociateContextWithMid, fonction (midatlax.h)

Article
02/07/2025

RxAssociateContextWithMid associe le contexte opaque fourni à un ID multiplex disponible (MID) à 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 de retour

RxAssociateContextWithMid retourne STATUS_SUCCESS sur la réussite ou l’une des valeurs d’erreur suivantes :

Retourner le code	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 dans 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 ID multiplex (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 mapper des MID à RX_CONTEXT structures de données. 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.