TdiDeregisterNetAddress

NTSTATUS
   TdiDeregisterNetAddress(
       IN HANDLE AddrRegistrationHandle
       );

TdiDeregisterNetAddress 함수는 TdiRegisterNetAddress 함수의 반대이다. 이 함수는 TDI를 가지고 등록된 유효한 네트웍 주소 리스트로부터 트랜스포트 제공 네트웍 주소를 제거한다.

매개변수

AddrRegistrationHandle

TdiRegisterNetAddress 함수의 호출에 의해서 리턴된 핸들을 서술한다.

리턴값

등록이 해제되고 바인딩된 모든 클라이언트가 통보를 받았다면 TdiDeregisterNetAddress 함수는 STATUS_SUCCESS를 리턴한다. 그렇지 않으면 STATUS_INSUFFICIENT_RESOURCES를 리턴할 수 있다.(시스템 자원의 사용가능성이 동적이기 때문에 같은 트랜스포트로부터의 순차적인 호출은 성공한다.)

주석

연결해제가 원격지에서 시작되든 아니든, 트랜스포트 자체가 이 연산을 시작했기 때문에 그기고 가능하다면 하부의 NIC과의 바인딩을 끊기 때문에 원격지로부터의 연결해체가 발생했을 때 TDI 트랜스포트는 TdiDeregisterNetAddress 함수를 호출한다. 각각의 경우에 트랜스포트는 TdiRegisterNetAddress 함수를 가지고 등록된 네트웍 주소에 대해서 유지하는 상태를 끊어야한다.

TdiDeregisterNetAddress 함수는 트랜스포트의 클라이언트가 미리 등록된 네트웍 주소로부터 데이타를 더이상 보내고 받을 수 없다는 것을 인식한다. 이 호출이 발생했을 때 TDI는 이 통보를 받기 위해서 TdiRegisterPnPHandlers 함수를 가지고 자신을 등록한 모든 클라이언트의 ClientPnPDelNetAddress 함수를 호출한다. ClientPnPDelNetAddress 함수로의 이러한 호출이 발생할 때 열린 주소를 클라이언트가 가진다면 클라이언트는 그 주소를 닫는다.

TdiDeregisterNetAddress 함수가 STATUS_INSUFFICIENT_RESOURCES를 리턴한다면 트랜스포트는 등록된 네트웍 주소를 지시하는 순차적인 들어오는 클라이언트 보내기를 실패해야한다. 리턴값이 적절할 때 트랜스포트는 사용할 수 있는 시스템 메모리의 임시 부족이 원래의 호출을 실패하도록 하기 때문에 다시 TdiDeregisterNetAddress 함수를 호출해야한다.

TdiDeregisterNetAddress 함수의 호출자는 IRQL < DISPATCH_LEVEL에서 실행된다.