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

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

Синтаксис

HANDLE CfGetWin32HandleFromProtectedHandle(
  [in] HANDLE ProtectedHandle
);

Параметры

[in] ProtectedHandle

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

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

Соответствующий дескриптор Win32.

Комментарии

Вызывающий объект должен ссылаться на защищенный дескриптор перед этим вызовом с помощью CfReferenceProtectedHandle , чтобы убедиться, что использование дескриптора Win32 отслеживается, а вызов API Win32, использующий дескриптор Win32, синхронизируется с подтверждением уведомления о прерывании операции.

Вызывающий объект должен освободить ссылку на защищенный дескриптор после завершения работы с дескриптором Win32 с помощью CfReleaseProtectedHandle.

Ни при каких обстоятельствах вызывающий объект не должен закрывать дескриптор Win32, возвращенный с помощью CfCloseHandle.

Требования

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

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

CfReferenceProtectedHandle

CfReleaseProtectedHandle

CfCloseHandle