피드백

NdisIfFreeNetLuidIndex 함수(ndis.h)

  • 아티클
  • 읽는 데 3분 걸림

NdisIfFreeNetLuidIndex 함수는 이전에 NdisIfAllocateNetLuidIndex 함수 호출에 의해 할당된 네트워크 인터페이스 NET_LUID 인덱스를 해제합니다.

구문

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에 반환하여 다른 인터페이스로 다시 할당할 수 있습니다. 호출자는 NdisIfAllocateNetLuidIndex 함수를 호출하여 NET_LUID 인덱스를 할당할 때 사용한 것과 동일한 인터페이스 형식을 IfType에 전달해야 합니다.

공급자는 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