Compartilhar via


Método DiskQuotaControl.FindUser

Localiza a entrada de um usuário, por nome, no arquivo de cota do volume.

Sintaxe

DiskQuotaControl.FindUser(
  sLogonName
)

Parâmetros

sLogonName

Tipo: Cadeia de caracteres

Um valor de cadeia de caracteres que contém o nome de logon do usuário.

Valor retornado

Retorna uma expressão de objeto que é avaliada para o objeto DIDiskQuotaUser do usuário.

Comentários

Esse método retorna um objeto DIDiskQuotaUser mesmo que não haja nenhuma entrada para o usuário no arquivo de cota. O objeto de usuário retornado tem limite de aviso e limites de cota rígidos definidos para os valores padrão do volume.

A cadeia de caracteres retornada de TranslateLogonNameToSID pode ser passada no lugar do parâmetro sLogonName . Quando FindUser recebe uma cadeia de caracteres SID, ele usa o SID correspondente para pesquisa direta do registro de cota do usuário no volume. Isso ignora o cache de nome de SID. Nos casos em que FindUser falha devido a uma incompatibilidade no formato (por exemplo, compatível com SAM e UPN) do nome de logon fornecido e do nome de logon armazenado em cache, o nome do logon pode ser convertido em uma cadeia de caracteres SID usando TranslateLogonNameToSID e, em seguida, passado novamente para FindUser. O código VBScript a seguir ilustra essa técnica.

Function Find(dqc, name)
    On Error Resume Next
    SET Find = dqc.FindUser(name)

    If Err.Number <> 0 Then
        Err.Clear
        SET Find = dqc.FindUser(dqc.TranslateLogonNameToSID(name))
    End If    

End Function

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
DLL
Shell32.dll (versão 5.0 ou posterior)

Confira também

Objeto DiskQuotaControl