функция обратного вызова NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN (netioddk.h)

  • Статья

Функция обратного вызова ProviderCleanupBindingContext модуля поставщика выполняет любую необходимую очистку и освобождение контекста привязки модуля поставщика после отсоединения модуля поставщика и клиентского модуля друг от друга.

Синтаксис

NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN NpiProviderCleanupBindingContextFn;

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

Параметры

[in] ProviderBindingContext

Указатель на контекст модуля поставщика для привязки между модулем поставщика и клиентским модулем, от которого он отсоединился. Функция обратного вызова ProviderAttachClient модуля поставщика возвращает этот указатель на NMR при подключении к клиентскому модулю.

Возвращаемое значение

None

Remarks

NMR вызывает функцию обратного вызова ProviderCleanupBindingContext модуля поставщика после того, как поставщик и клиентский модуль отсоединились друг от друга.

Функция обратного вызова ProviderCleanupBindingContext модуля поставщика должна выполнять необходимую очистку данных, содержащихся в структуре контекста привязки модуля поставщика. Затем он должен освободить память для структуры контекста привязки, если модуль поставщика динамически выделяет память для структуры.

Если модуль поставщика динамически не выделяет память для контекста привязки и никакой другой очистки контекста привязки не требуется, то модулю поставщика не нужно реализовывать функцию обратного вызова ProviderCleanupBindingContext . Если модуль поставщика не реализует функцию обратного вызова ProviderCleanupBindingContext, он должен задать элемент ProviderCleanupBindingContext NPI_PROVIDER_CHARACTERISTICS структуры значение NULL при вызове функции NmrRegisterProvider для регистрации в NMR.

NMR вызывает функцию обратного вызова ProviderCleanupBindingContext модуля поставщика при любом irQL <= DISPATCH_LEVEL.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа Windows
Header netioddk.h (включая Wsk.h)
IRQL <= DISPATCH_LEVEL

См. также раздел

ClientDetachProvider

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient

ProviderDetachClient