Função QueryUsersOnEncryptedFile (winefs.h)

  • Artigo

Recupera uma lista de usuários para o arquivo especificado.

Sintaxe

DWORD QueryUsersOnEncryptedFile(
  [in]  LPCWSTR                           lpFileName,
  [out] PENCRYPTION_CERTIFICATE_HASH_LIST *pUsers
);

Parâmetros

[in] lpFileName

O nome do arquivo.

[out] pUsers

Um ponteiro para uma estrutura ENCRYPTION_CERTIFICATE_HASH_LIST que recebe a lista de usuários.

Valor retornado

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 usuários não for mais necessária, chame a função FreeEncryptionCertificateHashList para liberar a lista.

No Windows 8, Windows Server 2012 e posteriores, essa função tem suporte nas tecnologias a seguir.

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

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

Requisitos

   
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-0 (introduzido no Windows 8)

Confira também

ENCRYPTION_CERTIFICATE_HASH_LIST

Criptografia de Arquivo

Funções de gerenciamento de arquivos

FreeEncryptionCertificateHashList