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

  • Artigo

Adiciona uma nova entrada de cota no volume para o usuário especificado. O usuário é identificado pelo nome de domínio e conta.

Sintaxe

HRESULT AddUserName(
  [in]  LPCWSTR         pszLogonName,
  [in]  DWORD           fNameResolution,
  [out] PDISKQUOTA_USER *ppUser
);

Parâmetros

[in] pszLogonName

A cadeia de caracteres de nome de logon da conta 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 contêiner, nome de logon e nome de exibição) 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. AddUserName 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. AddUserName retorna quando as informações são resolvidas. Se as informações existirem no cache 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

Um ponteiro para o ponteiro da interface IDiskQuotaUser para o objeto de usuário de cota recém-criado.

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.
S_FALSE
 O usuário já existe. Não adicionado.
ERROR_NOT_READY
 O objeto DiskQuotaControl não é inicializado.
ERROR_USER_UNKNOWN
 O nome de usuário especificado é desconhecido.
E_INVALIDARG
 Um parâmetro de ponteiro é 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

O sistema de arquivos NTFS cria automaticamente uma entrada de cota de usuário quando um usuário grava no volume pela primeira vez. As entradas criadas automaticamente recebem o limite de aviso padrão e os valores de limite de cota fixa para o volume. Esse método permite que você crie uma entrada de cota de usuário antes que um usuário tenha gravado informações no volume. Portanto, você pode pré-atribuir um limite de aviso ou um valor de limite de cota rígido diferente das 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