Compartilhar via

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

  • Artigo

Localiza uma entrada de usuário específica nas informações de cota de volume. O SID (identificador de segurança) do usuário é usado como a chave de pesquisa.

Sintaxe

HRESULT FindUserSid(
  [in]  PSID            pUserSid,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

Parâmetros

[in] pUserSid

Um ponteiro para o SID do usuário.

[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. FindUserSid 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. FindUserSid 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] ppUser

Ponteiro para receber o ponteiro da interface IDiskQuotaUser para o objeto de usuário de cota.

Valor retornado

Esse método retorna um erro do sistema de arquivos ou 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.
ERROR_INVALID_SID
 O SID do usuário é inválido.
E_INVALIDARG
 O parâmetro pUserSid ou ppUser é NULL.
E_OUTOFMEMORY
 Memória insuficiente.
E_FAIL
 Ocorreu um erro inesperado do sistema de arquivos.
E_UNEXPECTED
 Ocorreu uma exceção inesperada.

Comentários

Esse método retornará um objeto de usuário mesmo que não haja registro de cota para o usuário no arquivo de cota. Isso é consistente com a ideia de adição automática de usuário e configurações de cota padrão. Se atualmente não houver nenhuma entrada de cota para o usuário solicitado e o usuário for adicionado ao arquivo de cota se ele solicitar espaço em disco, o objeto de usuário retornado terá limite de aviso e limites de cota rígidos iguais às configurações padrão do volume.

Requisitos

   
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