Função QueryRecoveryAgentsOnEncryptedFile (winefs.h)

  • Artigo

Recupera uma lista de agentes de recuperação para o arquivo especificado.

Sintaxe

DWORD QueryRecoveryAgentsOnEncryptedFile(
  [in]  LPCWSTR                           lpFileName,
  [out] PENCRYPTION_CERTIFICATE_HASH_LIST *pRecoveryAgents
);

Parâmetros

[in] lpFileName

O nome do arquivo.

[out] pRecoveryAgents

Um ponteiro para uma estrutura ENCRYPTION_CERTIFICATE_HASH_LIST que recebe uma lista de agentes de recuperação.

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema. Para obter uma lista completa de códigos de erro, consulte Códigos de erro do sistema ou o arquivo de cabeçalho WinError.h.

Comentários

Quando a lista de agentes de recuperação não for mais necessária, libere-a chamando a função FreeEncryptionCertificateHashList .

Em Windows 8, Windows Server 2012 e posteriores, essa função é compatível com as tecnologias a seguir.

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 Sim
TFO (Failover transparente) do SMB 3.0 No
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) No
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) No
ReFS (Sistema de Arquivos Resiliente) No
 

O SMB 3.0 não dá suporte ao EFS em compartilhamentos com capacidade de disponibilidade contínua.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winefs.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll
Conjunto de APIs ext-ms-win-advapi32-encryptedfile-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)

Confira também

ENCRYPTION_CERTIFICATE_HASH_LIST

Criptografia de Arquivo

Funções de gerenciamento de arquivos

FreeEncryptionCertificateHashList