Partager via


Fonction CfGetWin32HandleFromProtectedHandle (cfapi.h)

Convertit un handle protégé en handle Win32 afin qu’il puisse être utilisé avec toutes les API Win32 basées sur un handle.

Syntaxe

HANDLE CfGetWin32HandleFromProtectedHandle(
  [in] HANDLE ProtectedHandle
);

Paramètres

[in] ProtectedHandle

Handle protégé à convertir.

Valeur retournée

Handle Win32 correspondant.

Remarques

L’appelant doit avoir référencé le handle protégé avant cet appel à l’aide de CfReferenceProtectedHandle pour s’assurer que l’utilisation du handle Win32 est suivie et que l’appel d’API Win32 qui utilise le handle Win32 est synchronisé avec l’accusé de réception de notification d’arrêt d’opération.

L’appelant doit libérer la référence sur le handle protégé après avoir terminé avec le handle Win32 à l’aide de CfReleaseProtectedHandle.

En aucun cas, l’appelant ne doit fermer le handle Win32 retourné à l’aide de CfCloseHandle.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête cfapi.h
Bibliothèque CldApi.lib
DLL CldApi.dll

Voir aussi

CfReferenceProtectedHandle

CfReleaseProtectedHandle

CfCloseHandle