Função RxAssociateContextWithMid (midatlax.h)

Artigo
02/26/2024

RxAssociateContextWithMid associa o contexto opaco fornecido a uma MID (ID multiplex) 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.

Retornar valor

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 era 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 definido quando a estrutura MID_ATLAS foi criada.

Comentários

O RDBSS define uma ID multiplex (MID), um valor de 16 bits, que pode ser usado pelo cliente de rede (minidiretório) e pelo servidor para distinguir entre as solicitações ativas simultaneamente 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 estruturas de dados RX_CONTEXT. RxAssociateContextWithMid aloca memória de pool não paginado ao criar uma nova estrutura de dados MID_MAP.

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