CfGetWin32HandleFromProtectedHandle-Funktion (cfapi.h)

Konvertiert ein geschütztes Handle in ein Win32-Handle, sodass es mit allen handle-basierten Win32-APIs verwendet werden kann.

Syntax

HANDLE CfGetWin32HandleFromProtectedHandle(
  [in] HANDLE ProtectedHandle
);

Parameter

[in] ProtectedHandle

Das zu konvertierende geschützte Handle.

Rückgabewert

Das entsprechende Win32-Handle.

Hinweise

Der Aufrufer muss vor diesem Aufruf mithilfe von CfReferenceProtectedHandle auf das geschützte Handle verwiesen haben, um sicherzustellen, dass die Verwendung des Win32-Handle nachverfolgt wird, und der Win32-API-Aufruf, der das Win32-Handle nutzt, mit der Bestätigung der Oplock-Unterbrechungsbenachrichtigung synchronisiert wird.

Der Aufrufer muss den Verweis auf das geschützte Handle freigeben, nachdem er mit dem Win32-Handle mithilfe von CfReleaseProtectedHandle ausgeführt wurde.

In keinem Fall sollte der Aufrufer das win32-Handle schließen, das mithilfe von CfCloseHandle zurückgegeben wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	cfapi.h
Bibliothek	CldApi.lib
DLL	CldApi.dll

Weitere Informationen

CfReferenceProtectedHandle

CfReleaseProtectedHandle

CfCloseHandle