ClientEventError

NTSTATUS
   ClientEventError (
       IN PVOID TdiEventContext,
       IN NTSTATUS Status
      );

ClientEventError 함수는 트랜스포트 자체에서 혹은 신뢰할 수 없는 특정 로컬 트랜스포트 주소상에서 I/O를 하는 더 하위의 네트웍 드라이버에서 하부의 TDI 트랜스포트가 에러에 대한 응답으로 호출하는 이벤트 핸들러이다.

매개변수

TdiEventContext

ClientEventError 함수가 하부의 트랜스포트를 가지고 등록될 때 TdiBuildSetEventHandler 함수를 가지고 설정된 IRP안에 제공된 클라이언트 제공 컨텍스트를 가리킨다.

Status

ClientEventError 함수로의 이 호출이 야기하는 상태에 대해서 정보를 제공하는 NTSTATUS 값을 서술한다.

리턴값

ClientEventError 함수는 STATUS_SUCCESS를 리턴할 수 있다.

주석

ClientEventError 함수로의 호출은 로컬 클라이언트에게 트랜스포트 스택의 하위 프로토콜 층중에 하나에서 혹은 트랜스포트 스택이 바인딩된 하부의 NDIS NIC 드라이버에서 하부 TDI 트랜스포트안에 에러 상태를 알린다. 그러한 에러가 발생한다면 TDI 트랜스포트는 에러 상태를 만난 하부의 드라이버에 의존하는 모든 열린 주소상의 각각의 클라이언트를 위해서 현재 등록된 모든 ClientEventError 핸들러를 호출한다.

ClientEventError 함수로의 호출은 불행한 실패를 인디케이트할 수 있다. 그러한 호출 후에 클라이언트는 사용을 중지하고 몇몇의 경우에 이 통보와 연관된 트랜스포트 주소를 구현하는 파일 객체를 닫는다. 이 주소가 엔드포인트 대 엔드포인트 연결과 연관되었다면 ClientEventError 함수는 연결이 파괴되었다고 가정한다.

결국 ClientEventError 핸들러는 보통 주소나 그 주소와 연관된 모든 연결 엔드포인트에 대해서 유지하는 어떤 상태를 클리어한다. 즉 클라이언트는 상위 레벨 컴포넌트에게 실패의 주소상에서 지연된 연산을 처리하고 있다고 알린다. 그리고나서 클라이언트는 그들의 연산과 관계가 있는 미리 할당된 모든 자원을 해제한다.

ClientEventError 함수는 IRQL DISPATCH_LEVEL에서 연산을 수행할 능력이 있어야한다.