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