Compartilhar via


Função CfReferenceProtectedHandle (cfapi.h)

Permite que o chamador faça referência a um identificador protegido para um identificador Win32 que pode ser usado com APIs Win32 não CfApi.

Sintaxe

BOOLEAN CfReferenceProtectedHandle(
  [in] HANDLE ProtectedHandle
);

Parâmetros

[in] ProtectedHandle

O identificador protegido de um arquivo de espaço reservado.

Retornar valor

Se essa função for bem-sucedida, ela retornará TRUE. Caso contrário, ele retornará FALSE.

Comentários

Cada chamada cfReferenceProtectedHandle deve ser correspondida a uma chamada CfReleaseProtectedHandle . Não é recomendável referenciar um identificador protegido por um longo período de tempo, pois isso impedirá que a notificação de interrupção do oplock seja confirmada.

Em vez disso, o chamador deve dividir tarefas de execução prolongada em subtarefas menores e referenciar/liberar o identificador protegido para cada subtarefa.

Requisitos

   
Cliente mínimo com suporte Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho cfapi.h
Biblioteca CldApi.lib
DLL CldApi.dll

Confira também

CfReleaseProtectedHandle