Método IDiskQuotaControl::CreateEnumUsers (dskquota.h)

Artigo
08/23/2023

Cria um objeto enumerador para enumerar usuários de cota no volume. O objeto recém-criado implementa a interface IEnumDiskQuotaUsers .

Sintaxe

HRESULT CreateEnumUsers(
  [in]  PSID                  *rgpUserSids,
  [in]  DWORD                 cpSids,
  [in]  DWORD                 fNameResolution,
  [out] PENUM_DISKQUOTA_USERS *ppEnum
);

Parâmetros

[in] rgpUserSids

Uma matriz de ponteiros sid (identificador de segurança) que representam os objetos de usuário a serem incluídos na enumeração. Se esse valor for NULL, todas as entradas de usuário serão enumeradas.

[in] cpSids

O número de itens na matriz rgpUserSids . Ignorado se rgpUserSids for NULL.

[in] fNameResolution

Indica como as informações da conta de usuário devem ser obtidas. As informações de cota do volume identificam os usuários por SID. As informações da conta de usuário (como nome de domínio, nome da conta e nome completo) devem ser obtidas do controlador de domínio de rede ou do computador local se não estiver em uma rede. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
DISKQUOTA_USERNAME_RESOLVE_ASYNC 2	Resolva as informações da conta de usuário de forma assíncrona. O método IEnumDiskQuotaUsers::Next retorna imediatamente. O chamador deve implementar a interface IDiskQuotaEvents para receber notificação quando as informações estiverem disponíveis. Se as informações tiverem sido armazenadas em cache durante uma solicitação anterior, a notificação ocorrerá assim que o objeto for atendido. Caso contrário, o método obtém as informações do controlador de domínio de rede e notifica IDiskQuotaEvents.
DISKQUOTA_USERNAME_RESOLVE_NONE 0	Não resolve informações da conta de usuário.
DISKQUOTA_USERNAME_RESOLVE_SYNC 1	Resolva as informações da conta de usuário de forma síncrona. O método IEnumDiskQuotaUsers::Next retorna quando as informações são resolvidas. Se as informações existirem no cache de SID de cota de disco, elas serão retornadas imediatamente. Caso contrário, o método deve localizar as informações. Isso pode levar vários minutos.

[out] ppEnum

Um ponteiro para um ponteiro para o enumerador IEnumDiskQuotaUsers .

Retornar valor

Esse método retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	Êxito.
ERROR_ACCESS_DENIED	O chamador não tem direitos de acesso suficientes.
ERROR_NOT_READY	O objeto DiskQuotaControl não é inicializado.
E_INVALIDARG	O parâmetro ppEnum é NULL.
E_OUTOFMEMORY	Memória insuficiente.
E_UNEXPECTED	Ocorreu uma exceção inesperada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [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	dskquota.h
DLL	Dskquota.dll

Confira também

Interfaces do gerenciamento de disco

Cotas de disco

IDiskQuotaControl

Compartilhar via