Функция CfReferenceProtectedHandle (cfapi.h)

Позволяет вызывающей объекту ссылаться на защищенный дескриптор Win32, который можно использовать с API Win32, не использующего CfApi.

Синтаксис

BOOLEAN CfReferenceProtectedHandle(
  [in] HANDLE ProtectedHandle
);

Параметры

[in] ProtectedHandle

Защищенный дескриптор файла заполнителя.

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

Если эта функция завершается успешно, она возвращает .TRUE В противном случае она возвращает FALSE.

Комментарии

Каждый вызов CfReferenceProtectedHandle должен соответствовать вызову CfReleaseProtectedHandle . Не рекомендуется ссылаться на защищенный дескриптор в течение длительного периода времени, так как это предотвратит подтверждение уведомления о разрыве блокировки.

Вместо этого вызывающий объект должен разбить длительные задачи на более мелкие вложенные задачи и сослаться на защищенный дескриптор для каждой подзадаки или освободить его.

Требования

Минимальная версия клиента	Windows 10 версии 1709 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	cfapi.h
Библиотека	CldApi.lib
DLL	CldApi.dll

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

CfReleaseProtectedHandle