共用方式為

RxPrefixTableLookupName 函式 （prefix.h）

  • 發行項

RxPrefixTableLookupName 在前置詞數據表中查閱名稱，以用於目錄SRV_CALL、NET_ROOT和V_NET_ROOT名稱，並將基礎指標轉換成包含名稱的結構。

語法

PVOID RxPrefixTableLookupName(
  [in]  IN PRX_PREFIX_TABLE  ThisTable,
  [in]  IN PUNICODE_STRING   CanonicalName,
  [out] OUT PUNICODE_STRING  RemainingName,
        IN PRX_CONNECTION_ID ConnectionId
);

參數

[in] ThisTable

要在其中查看之RX_PREFIX_TABLE結構的指標。

[in] CanonicalName

要查閱之 Unicode 字串名稱的指標。

[out] RemainingName

不相符之名稱部分之 Unicode 字串名稱的指標。

ConnectionId

選擇性參數，表示要使用的RX_CONNECTION_ID指標。

傳回值

RxPrefixTableLookupName 會傳回找到相符專案時找到之節點的指標。 如果找不到相符專案，RxPrefixTableLookupName 會傳回 NULL 指標。

言論

RDBSS 會在內部使用此例程來回應 MUP 的呼叫，以宣告名稱或形成NET_ROOT或V_NET_ROOT結構的建立路徑。 RxPrefixTableLookupName 例程也可以由網路迷你重新導向器使用，只要在存取數據表之前取得適當的鎖定，並在工作完成時釋放鎖定。 驅動程式的一般用法如下所示：

  • 呼叫 RxpAcquirePrefixTableLockShared來取得共享鎖定。
  • 呼叫 RxPrefixTableLookupName來查閱名稱。
  • 呼叫 RxpReleasePrefixTableLock來釋放共享鎖定。
請注意，如果找到相符專案，則找到節點上的參考計數將會遞增。

在檢查的組建中，如果 CanonicalName 字串的長度不大於零，RxPrefixTableLookupName 會導致系統 ASSERT。

要求

要求 價值
目標平臺 桌面
標頭 prefix.h （include Prefix.h）
IRQL <= APC_LEVEL

另請參閱

RxpAcquirePrefixTableLockExclusive

RxpAcquirePrefixTableLockShared

RxpReleasePrefixTableLock