RxAssociateContextWithMid 函式 (midatlax.h)

發行項
02/29/2024

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

語法

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

參數

MidAtlas

MID_ATLAS數據結構的指標。

Context

內容的指標。

NewMid

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

傳回值

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

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

備註

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

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