Funzione CfReferenceProtectedHandle (cfapi.h)

Consente al chiamante di fare riferimento a un handle protetto a un handle Win32 che può essere usato con API Win32 non CfApi.

Sintassi

BOOLEAN CfReferenceProtectedHandle(
  [in] HANDLE ProtectedHandle
);

Parametri

[in] ProtectedHandle

Handle protetto di un file segnaposto.

Valore restituito

Se questa funzione ha esito positivo, restituisce TRUE. In caso contrario, viene restituito FALSE.

Commenti

Ogni chiamata CfReferenceProtectedHandle deve essere associata a una chiamata CfReleaseProtectedHandle . Non è consigliabile fare riferimento a un handle protetto per un lungo periodo di tempo, perché in questo modo si impedisce che la notifica di interruzione del blocco venga riconosciuta.

Il chiamante deve invece suddividere le attività a esecuzione prolungata in sottoattività più piccole e fare riferimento/rilasciare l'handle protetto per ogni sottoattività.

Requisiti

Client minimo supportato	Windows 10 versione 1709 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	cfapi.h
Libreria	CldApi.lib
DLL	CldApi.dll

Vedi anche

CfReleaseProtectedHandle