共用方式為


NdisIfFreeNetLuidIndex 函式 (ndis.h)

NdisIfFreeNetLuidIndex 函式會釋放先前由 呼叫 所配置的網路介面 NET_LUID 索引 NdisIfAllocateNetLuidIndex 函式。

語法

NDIS_STATUS NdisIfFreeNetLuidIndex(
       NET_IFTYPE ifType,
  [in] UINT32     NetLuidIndex
);

參數

ifType

已配置索引的介面類型。 呼叫端必須提供它配置NET_LUID索引與 NdisIfAllocateNetLuidIndex時所使用的相同值。 如需介面類型清單,請參閱 NDIS 介面類型

[in] NetLuidIndex

NDIS 應該釋放NET_LUID索引值。 此索引是在先前呼叫 NdisIfAllocateNetLuidIndex中配置。

傳回值

NdisIfFreeNetLuidIndex 會傳回下列其中一個值:

傳回碼 描述
NDIS_STATUS_SUCCESS
作業已順利完成。
DIS_STATUS_INVALID_PARAMETER
NdisIfFreeNetLuidIndex 失敗,因為 NetLuidIndex 參數指定了未配置給指定 ifType IfType 參數類型的索引。
 

如果呼叫 NdisIfFreeNetLuidIndex 失敗,介面提供者應該移除儲存在與索引相關之持續性記憶體中的任何資訊。 拿掉資訊可確保提供者不會繼續嘗試釋放電腦重新啟動后已釋放的索引。

言論

NDIS 介面提供者會呼叫 NdisIfFreeNetLuidIndex 函式來釋放 NET_LUID 索引。 只有當本機計算機上不再使用介面時,介面提供者才應該釋放NET_LUID索引。

NdisIfFreeNetLuidIndex 會傳回先前配置的NET_LUID索引給 NDIS,以便可能重新配置到另一個介面。 呼叫端必須傳入相同介面類型,IfType 呼叫 時所使用的介面類型 NdisIfAllocateNetLuidIndex 函式來配置NET_LUID索引。

提供者不應該在呼叫 NdisIfFreeNetLuidIndex之後,於任何其他 NDIS 函數調用中使用釋放NET_LUID索引或相關聯的NET_LUID值。

要求

要求 價值
最低支援的用戶端 NDIS 6.0 和更新版本支援。
目標平臺 桌面
標頭 ndis.h (包括 Ndis.h)
連結庫 Ndis.lib
IRQL PASSIVE_LEVEL
DDI 合規性規則 Irql_Interfaces_Function(ndis)

另請參閱

NET_LUID

NdisIfAllocateNetLuidIndex