QueryUsersOnEncryptedFile

The QueryUsersOnEncryptedFile function retrieves a list of users for the specified file.

DWORD QueryUsersOnEncryptedFile(
  LPCWSTR lpFileName,                        // file name
  PENCRYPTION_CERTIFICATE_HASH_LIST *pUsers  // hash list
);

Parameters

lpFileName

[in] Pointer to a null-terminated Unicode string that specifies the name of the file to query.

pUsers

[out] Receives a list of users, represented by a ENCRYPTION_CERTIFICATE_HASH_LIST structure.

Return Values

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is a Win32 error code. For a complete list of error codes, see Error Codes or the Platform SDK header file WinError.h.

Remarks

When the list of users is no longer needed, call the FreeEncryptionCertificateHashList function to free the list.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Winefs.h; include Windows.h.
  Library: Use Advapi32.lib.

See Also

File Systems Overview, File System Functions, ENCRYPTION_CERTIFICATE_HASH_LIST, FreeEncryptionCertificateHashList