NdisIfFreeNetLuidIndex-Funktion (ndis.h)

  • Artikel

Die NdisIfFreeNetLuidIndex-Funktion gibt eine Netzwerkschnittstelle NET_LUID Index frei, die zuvor durch einen Aufruf des zugeordnet wurde. NdisIfAllocateNetLuidIndex-Funktion .

Syntax

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

Parameter

ifType

Der Schnittstellentyp, für den der Index zugeordnet wurde. Der Aufrufer muss denselben Wert angeben, den er verwendet hat, als er den NET_LUID Index mit NdisIfAllocateNetLuidIndex zugeordnet hat. Eine Liste der Schnittstellentypen finden Sie unter NDIS-Schnittstellentypen.

[in] NetLuidIndex

Der NET_LUID Indexwert, den NDIS frei geben soll. Dieser Index wurde in einem vorherigen Aufruf von NdisIfAllocateNetLuidIndex zugeordnet.

Rückgabewert

NdisIfFreeNetLuidIndex gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
NDIS_STATUS_SUCCESS
 Der Vorgang wurde erfolgreich abgeschlossen.
DIS_STATUS_INVALID_PARAMETER
 Fehler bei NdisIfFreeNetLuidIndex, weil der NetLuidIndex-Parameter einen Index angegeben hat, der nicht für den Typ zugeordnet wurde, den der IfType-Parameter angegeben hat.
 

Wenn der Aufruf von NdisIfFreeNetLuidIndex fehlschlägt, sollte der Schnittstellenanbieter alle Informationen entfernen, die er im persistenten Speicher gespeichert hat, der sich auf den Index bezieht. Wenn Sie die Informationen entfernen, wird sichergestellt, dass der Anbieter nicht ständig versucht, einen Index frei zu geben, der nach dem Neustart des Computers bereits freigegeben wurde.

Hinweise

NDIS-Schnittstellenanbieter rufen die NdisIfFreeNetLuidIndex-Funktion auf, um einen NET_LUID Index freizugeben. Der Schnittstellenanbieter sollte den NET_LUID Index nur freigeben, wenn die Schnittstelle auf dem lokalen Computer nicht mehr verwendet wird.

NdisIfFreeNetLuidIndex gibt einen zuvor zugeordneten NET_LUID Index an NDIS zurück, um eine mögliche Neuzuordnung auf eine andere Schnittstelle zu ermöglichen. Der Aufrufer muss denselben Schnittstellentyp an IfType übergeben, den er beim Aufrufen von verwendet hat. NdisIfAllocateNetLuidIndex-Funktion , um den NET_LUID Index zuzuordnen.

Der Anbieter sollte den freigegebenen NET_LUID Index oder den zugeordneten NET_LUID-Wert nicht in anderen NDIS-Funktionsaufrufen verwenden, nachdem er NdisIfFreeNetLuidIndex aufgerufen hat.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Zielplattform Desktop
Kopfzeile ndis.h (include Ndis.h)
Bibliothek Ndis.lib
IRQL PASSIVE_LEVEL
DDI-Complianceregeln Irql_Interfaces_Function(ndis)

Weitere Informationen

NET_LUID

NdisIfAllocateNetLuidIndex