RxAssociateContextWithMid 函式（midatlax.h）

發行項
02/07/2025

RxAssociateContextWithMid 會將提供的不透明內容與來自MID_ATLAS的可用多任務標識碼（MID）產生關聯。

語法

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

參數

MidAtlas

MID_ATLAS數據結構的指標。

Context

內容的指標。

NewMid

要與內容相關聯的多任務標識碼指標。

傳回值

RxAssociateContextWithMid 會傳回成功STATUS_SUCCESS或下列其中一個錯誤值：

傳回碼	描述
STATUS_INSUFFICIENT_RESOURCES	當無法為新的MID_MAP數據結構配置足夠的記憶體時，就會傳回此錯誤。
STATUS_UNSUCCESSFUL	這個錯誤會針對數個案例傳回，包括已使用中的 MID 數目大於建立MID_ATLAS結構時所設定的 MID 數目上限。

言論

RDBSS 會定義 Multiplex ID （MID），這是 16 位值，網路用戶端（迷你重新導向器）和伺服器都可以使用，以區分任何連線上同時作用中的要求。 MID 是透過呼叫 RxCreateMidAtlas所配置之MID_ATLAS數據結構的元件。 MID_MAP數據結構會配置並用於將 MID 對應至RX_CONTEXT數據結構。 RxAssociateContextWithMid 在建立新的MID_MAP數據結構時配置非分頁集區內存。

pContext 參數可以是任何不透明的內容，但通常是RX_CONTEXT。