Função RxAssociateContextWithMid (midatlax.h)

Artigo
02/07/2025

RxAssociateContextWithMid associa o contexto opaco fornecido a uma ID multiplex (MID) disponível de um MID_ATLAS.

Sintaxe

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

Parâmetros

MidAtlas

Um ponteiro para a estrutura de dados MID_ATLAS.

Context

Um ponteiro para o contexto.

NewMid

Um ponteiro para a ID multiplex a ser associada ao contexto.

Valor de retorno

RxAssociateContextWithMid retorna STATUS_SUCCESS com êxito ou um dos seguintes valores de erro:

Código de retorno	Descrição
STATUS_INSUFFICIENT_RESOURCES	Esse erro é retornado quando não foi possível alocar memória suficiente para a nova estrutura de dados MID_MAP.
STATUS_UNSUCCESSFUL	Esse erro é retornado para vários casos, incluindo quando o número de MIDs já em uso é maior que o número máximo de MIDs definidos quando a estrutura MID_ATLAS foi criada.

Observações

O RDBSS define uma ID multiplex (MID), um valor de 16 bits, que pode ser usado tanto pelo cliente de rede (minidiretório) quanto pelo servidor para distinguir entre as solicitações simultâneas ativas em qualquer conexão. Um MID é um componente de uma estrutura de dados MID_ATLAS alocada chamando RxCreateMidAtlas. Uma estrutura de dados MID_MAP é alocada e usada para mapear MIDs para RX_CONTEXT estruturas de dados. RxAssociateContextWithMid aloca memória de pool não paged ao criar uma nova estrutura de dados MID_MAP.

O parâmetro pContext pode ser qualquer contexto opaco, mas geralmente é um RX_CONTEXT.