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

  • Artigo

Localiza uma entrada específica nas informações de cota de volume. O nome de logon da conta do usuário é usado como a chave de pesquisa.

Sintaxe

HRESULT FindUserName(
  [in]  LPCWSTR         pszLogonName,
  [out] PDISKQUOTA_USER *ppUser
);

Parâmetros

[in] pszLogonName

Um ponteiro para o nome de logon da conta do usuário.

[out] ppUser

Um ponteiro para 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_INVALID_SID
 O SID do usuário é inválido.
ERROR_NONE_MAPPED
 Não há mapeamento disponível para o SID.
ERROR_NOT_READY
 O objeto DiskQuotaControl não é inicializado.
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