função de retorno de chamada NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN (netioddk.h)

A função de retorno de chamada ClientCleanupBindingContext de um módulo cliente executa qualquer limpeza e desalocação necessárias do contexto de associação do módulo cliente depois que o módulo cliente e um módulo do provedor se desanexaram um do outro.

Sintaxe

NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN NpiClientCleanupBindingContextFn;

void NpiClientCleanupBindingContextFn(
  [in] PVOID ClientBindingContext
)
{...}

Parâmetros

[in] ClientBindingContext

Um ponteiro para o contexto do módulo do cliente para a associação entre o módulo cliente e o módulo do provedor do qual ele desanexou. O módulo cliente passa esse ponteiro para a NMR quando chama a função NmrClientAttachProvider para anexar ao módulo do provedor.

Retornar valor

Nenhum

Comentários

A NMR chama a função de retorno de chamada ClientCleanupBindingContext de um módulo do cliente depois que o módulo do cliente e um módulo do provedor se desanexam um do outro.

A função de retorno de chamada ClientCleanupBindingContext de um módulo cliente deve executar qualquer limpeza necessária dos dados contidos na estrutura de contexto de associação do módulo cliente. Em seguida, ele deve liberar a memória para a estrutura de contexto de associação se o módulo do cliente alocar dinamicamente a memória para a estrutura.

Se o módulo cliente não aloca dinamicamente a memória para seu contexto de associação e nenhuma outra limpeza do contexto de associação é necessária, o módulo cliente não precisa implementar uma função de retorno de chamada ClientCleanupBindingContext . Se o módulo cliente não implementar uma função de retorno de chamada ClientCleanupBindingContext , ele deverá definir o membro ClientCleanupBindingContext do NPI_CLIENT_CHARACTERISTICS estrutura como NULL quando chama a função NmrRegisterClient para se registrar no NMR.

A NMR chama a função de retorno de chamada ClientCleanupBindingContext de um módulo cliente em qualquer IRQL <= DISPATCH_LEVEL.

Requisitos

Confira também

ClientAttachProvider

ClientDetachProvider

NPI_CLIENT_CHARACTERISTICS

NmrClientAttachProvider

ProviderDetachClient