TdiEnumerateAddresses

NTSTATUS
   TdiEnumerateAddresses(
       IN HANDLE BindingHandle
       );

TdiEnumerateAddresses 함수는 특정 트랜스포트와 NIC과의 바인딩에서 현재 등록된 네트웍 주소에 대해서 클라이언트에게 정보를 제공한다.

매개변수

BindingHandle

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

리턴값

TdiEnumerateAddresses 함수는 호출자가 주어진 바인딩에서 현재 등록된 모든 네트웍 주소를 인식할 때 STATUS_SUCCESS를 리턴한다. 그렇지 않으면 STATUS_INSUFFICIENT_RESOURCES를 리턴할 수 있다.

주석

TdiEnumerateAddresses 함수로의 클라이언트의 호출은 TdiRegisterPnPHandlers 함수를 가지고 클라이언트가 미리 등록한 ClientPnPAddNetAddress 함수로의 순차적인 호출을 시작한다. ClientPnPAddNetAddress 루틴으로의 그러한 각각의 호출은 하부의 트랜스포트에 의해서 TDI를 가지고 제공되고 등록된 현재 활성화된 네트웍 주소를 제공한다.

이 호출의 런타임 퍼포먼스 불이익에 대한 손해보다는 오히려 대부분의 클라이언트는 자신의 리스트가 손상됐다면 클라이언트 내부 리스트의 바인딩당 네트웍 주소의 유효성 입증을 제외하고는 TdiEnumerateAddresses 함수를 호출하지 않는다.

대신에 TDI 클라이언트는 바인딩이 성립됐을 때 바인딩 특정, 그리고 트랜스포트 등록 네트웍 주소를 위해서 자신의 내부 리스트를 설정한다. 그리고 TDI는 등록된 ClientPnPAddNetAddress 루틴으로 바인딩시 순차적인 호출을 해서 클라이언트는 그 바인딩 상에서 현재 등록된 네트웍 주소를 가지고 내부 리스트를 초기화할 수 있다.

그러한 내부 리스트를 설정하고 초기화한 후에 클라이언트의 ClientPnPAddNetAddress와 ClientPnPDelNetAddress 루틴은 동적으로 이 내부 리스트를 바인딩당 유효한 네트웍 주소로 업데이트한다. 클라이언트가 바인딩을 해제하기 전에 클라이언트는 순차적인 바인딩을 가지고 재사용하기 위해서 혹은 리스트와 연관된 할당된 모든 자원을 해제하기 위해서 그러한 내부 리스트를 클린업 해야한다.

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