Función QueryUsersOnEncryptedFile (winefs.h)
Recupera una lista de usuarios para el archivo especificado.
Sintaxis
DWORD QueryUsersOnEncryptedFile(
[in] LPCWSTR lpFileName,
[out] PENCRYPTION_CERTIFICATE_HASH_LIST *pUsers
);
Parámetros
[in] lpFileName
Nombre del archivo.
[out] pUsers
Puntero a una estructura ENCRYPTION_CERTIFICATE_HASH_LIST que recibe la lista de usuarios.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista completa de los códigos de error, consulta Códigos de error del sistema o el archivo de encabezado WinError.h.
Comentarios
Cuando ya no se necesite la lista de usuarios, llame a la función FreeEncryptionCertificateHashList para liberar la lista.
En Windows 8, Windows Server 2012 y versiones posteriores, esta función es compatible con las siguientes tecnologías.
| Tecnología | Compatible |
|---|---|
| Protocolo Bloque de mensajes del servidor (SMB) 3.0 | Sí |
| Conmutación por error transparente (TFO) de SMB 3.0 | No |
| SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | No |
| Sistema de archivos de Volumen compartido de clúster (CsvFS) | No |
| Sistema de archivos resistente a errores (ReFS) | No |
SMB 3.0 no admite EFS en recursos compartidos con funcionalidad de disponibilidad continua.
Requisitos
| Cliente mínimo compatible | Windows XP Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winefs.h (incluye Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |
| Conjunto de API | ext-ms-win-advapi32-encryptedfile-l1-1-0 (introducido en Windows 8) |
Consulte también
ENCRYPTION_CERTIFICATE_HASH_LIST