Función RxAssociateContextWithMid (midatlax.h)

Artículo
02/26/2024

RxAssociateContextWithMid asocia el contexto opaco proporcionado con un identificador multiplex disponible (MID) de un MID_ATLAS.

Sintaxis

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

Parámetros

MidAtlas

Puntero a la estructura de datos MID_ATLAS.

Context

Puntero al contexto.

NewMid

Puntero al identificador de multiplex que se va a asociar al contexto.

Valor devuelto

RxAssociateContextWithMid devuelve STATUS_SUCCESS si se ejecuta correctamente o uno de los siguientes valores de error:

Código devuelto	Descripción
STATUS_INSUFFICIENT_RESOURCES	Este error se devuelve cuando no era posible asignar suficiente memoria para la nueva estructura de datos MID_MAP.
STATUS_UNSUCCESSFUL	Este error se devuelve para varios casos, incluido cuando el número de MID que ya están en uso es mayor que el número máximo de MID establecidos cuando se creó la estructura de MID_ATLAS.

Comentarios

RDBSS define un id. de multiplex (MID), un valor de 16 bits, que puede usar el cliente de red (minidirector) y el servidor para distinguir entre las solicitudes activas simultáneamente en cualquier conexión. Mid es un componente de una estructura de datos MID_ATLAS asignada mediante una llamada a RxCreateMidAtlas. Se asigna una estructura de datos MID_MAP y se usa para asignar MID a RX_CONTEXT estructuras de datos. RxAssociateContextWithMid asigna memoria de grupo no paginada al crear una nueva estructura de datos MID_MAP.

El parámetro pContext puede ser cualquier contexto opaco, pero normalmente es un RX_CONTEXT.