Fonction CfReferenceProtectedHandle (cfapi.h)

Permet à l’appelant de référencer un handle protégé à un handle Win32 qui peut être utilisé avec des API Win32 non CfApi.

Syntaxe

BOOLEAN CfReferenceProtectedHandle(
  [in] HANDLE ProtectedHandle
);

Paramètres

[in] ProtectedHandle

Handle protégé d’un fichier d’espace réservé.

Valeur retournée

Si cette fonction réussit, elle retourne TRUE. Sinon, FALSEest retourné.

Notes

Chaque appel CfReferenceProtectedHandle doit être mis en correspondance avec un appel CfReleaseProtectedHandle . Il n’est pas recommandé de référencer un handle protégé pendant une longue période, car cela empêchera la notification d’arrêt d’opération d’être reconnue.

L’appelant doit à la place diviser les tâches longues en sous-tâches plus petites et référencer/libérer le handle protégé pour chaque sous-tâche.

Configuration requise

   
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

CfReleaseProtectedHandle