NdisIfFreeNetLuidIndex 関数 (ndis.h)

  • [アーティクル]

NdisIfFreeNetLuidIndex 関数は、 への呼び出しによって以前に割り当てられたインデックスNET_LUIDネットワーク インターフェイスを解放します。 NdisIfAllocateNetLuidIndex 関数。

構文

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

パラメーター

ifType

インデックスが割り当てられたインターフェイスの種類。 呼び出し元は、 NdisIfAllocateNetLuidIndex を使用してNET_LUID インデックスを割り当てるときに使用したのと同じ値を指定する必要があります。 インターフェイスの種類の一覧については、「 NDIS インターフェイスの種類」を参照してください。

[in] NetLuidIndex

NDIS が解放する必要があるNET_LUIDインデックス値。 このインデックスは、 NdisIfAllocateNetLuidIndex の以前の呼び出しで割り当てられました。

戻り値

NdisIfFreeNetLuidIndex は 、次のいずれかの値を返します。

リターン コード 説明
NDIS_STATUS_SUCCESS
 操作は正常に完了しました。
DIS_STATUS_INVALID_PARAMETER
 NetLuidIndex パラメーターで IfType パラメーターが指定した型に割り当てられなかったインデックスが指定されたため、NdisIfFreeNetLuidIndex が失敗しました。
 

NdisIfFreeNetLuidIndex の呼び出しが失敗した場合、インターフェイス プロバイダーは、インデックスに関連する永続ストレージに保存されたすべての情報を削除する必要があります。 情報を削除すると、コンピューターの再起動後に既に解放されているインデックスをプロバイダーが解放しようとし続けなくなります。

注釈

NDIS インターフェイス プロバイダーは NdisIfFreeNetLuidIndex 関数を呼び出して 、NET_LUID インデックスを解放します。 インターフェイス プロバイダーは、インターフェイスがローカル コンピューターで使用されなくなった場合にのみ、NET_LUID インデックスを解放する必要があります。

NdisIfFreeNetLuidIndex は、別のインターフェイスに再割り当てできるように、以前に割り当てられたNET_LUIDインデックスを NDIS に返します。 呼び出し元は、 を呼び出すときに使用したのと同じインターフェイス型を IfType で渡す必要があります。NET_LUID インデックスを割り当てる NdisIfAllocateNetLuidIndex 関数。

プロバイダーは、解放されたNET_LUID インデックス、または NdisIfFreeNetLuidIndex を呼び出した後、他の NDIS 関数呼び出しで関連付けられているNET_LUID値を使用しないでください。

要件

要件 値
サポートされている最小のクライアント NDIS 6.0 以降でサポートされています。
対象プラットフォーム デスクトップ
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 Irql_Interfaces_Function(ndis)

こちらもご覧ください

NET_LUID

NdisIfAllocateNetLuidIndex では、