Share via

Função CfGetWin32HandleFromProtectedHandle (cfapi.h)

  • Artigo

Converte um identificador protegido em um identificador Win32 para que ele possa ser usado com todas as APIs Win32 baseadas em identificador.

Sintaxe

HANDLE CfGetWin32HandleFromProtectedHandle(
  [in] HANDLE ProtectedHandle
);

Parâmetros

[in] ProtectedHandle

O identificador protegido a ser convertido.

Retornar valor

O identificador Win32 correspondente.

Comentários

O chamador deve ter referenciado o identificador protegido antes dessa chamada usando CfReferenceProtectedHandle para garantir que o uso do identificador Win32 seja rastreado e que a chamada à API do Win32 que consome o identificador Win32 seja sincronizada com a confirmação de notificação de interrupção do oplock.

O chamador deve liberar a referência no identificador protegido após ser feito com o identificador Win32 usando CfReleaseProtectedHandle.

Em nenhuma circunstância o chamador deve fechar o identificador Win32 retornado usando CfCloseHandle.

Requisitos

Requisito Valor
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

CfReferenceProtectedHandle

CfReleaseProtectedHandle

CfCloseHandle