Método IDiskQuotaControl::AddUserName (dskquota.h)
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 |
|---|---|
|
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. |
|
Não resolve informações da conta de usuário. |
|
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 |
|---|---|
|
Êxito. |
|
O usuário já existe. Não adicionado. |
|
O objeto DiskQuotaControl não é inicializado. |
|
O nome de usuário especificado é desconhecido. |
|
Um parâmetro de ponteiro é NULL. |
|
Memória insuficiente. |
|
Ocorreu um erro inesperado do sistema de arquivos. |
|
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 |