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

Vedi anche

CfReleaseProtectedHandle