Compartilhar via


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

A função ProviderCleanupBindingContext de um módulo de provedor executa qualquer limpeza e desalocação necessárias do contexto de associação do módulo do provedor após o módulo do provedor e um módulo cliente terem desanexado uns dos outros.

Sintaxe

NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN NpiProviderCleanupBindingContextFn;

void NpiProviderCleanupBindingContextFn(
  [in] PVOID ProviderBindingContext
)
{...}

Parâmetros

[in] ProviderBindingContext

Um ponteiro para o contexto do módulo do provedor para a associação entre o módulo do provedor e o módulo cliente do qual ele se desanexou. A função de retorno de chamada ProviderAttachClient do módulo do provedor retorna esse ponteiro para o NMR quando ele é anexado ao módulo cliente.

Valor de retorno

Nenhum

Observações

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

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

Se o módulo do provedor não alocar dinamicamente a memória para seu contexto de associação e nenhuma outra limpeza de seu contexto de associação for necessária, o módulo do provedor não precisará implementar um ProviderCleanupBindingContext função de retorno de chamada. Se o módulo do provedor não implementar uma função de retorno de chamada ProviderCleanupBindingContext, ele deverá definir o ProviderCleanupBindingContext membro do NPI_PROVIDER_CHARACTERISTICS estrutura para NULL quando chama a função NmrRegisterProvider para se registrar na NMR.

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino Windows
cabeçalho netioddk.h (inclua Wsk.h)
IRQL <= DISPATCH_LEVEL

Consulte também

ClientDetachProvider

NPI_PROVIDER_CHARACTERISTICS

providerAttachClient

ProviderDetachClient