Método DiskQuotaControl.TranslateLogonNameToSID

Converte um nome de logon para a ID de segurança de usuário correspondente no formato de cadeia de caracteres.

Sintaxe

DiskQuotaControl.TranslateLogonNameToSID(
  logonname
)

Parâmetros

logonname

Tipo: Cadeia de caracteres

Um valor de cadeia de caracteres que especifica o nome de logon do usuário.

Valor retornado

Retorna a SID (ID de segurança do usuário) no formato de cadeia de caracteres correspondente ao nome de logon fornecido. A cadeia de caracteres retornada inclui as chaves delimitador padrão. Por exemplo:

"{S-1-5-21-2127521184-1604012920-1887927527-19009}"

Comentários

A cadeia de caracteres SID retornada pode ser passada para o método FindUser no lugar de um nome de logon.

Quando uma chamada para o método FindUser( logonname) falha, pode ser devido a uma incompatibilidade entre o formulário (por exemplo, o gerenciador de contas de segurança [SAM] compatível e o nome upn]) do nome de logon fornecido e o formulário armazenado no cache de nome de SID. Nesses casos, o nome do logon pode ser convertido em um SID e a chamada para FindUser é repetida. FindUser reconhece uma cadeia de caracteres SID e ignorará a pesquisa de cache de nome SID. O código VBScript (Microsoft Visual Basic Scripting Edition) 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

A tradução de nome para SID pode ser um processo lento quando comparada a pesquisas no cache de nome de SID. Portanto, é recomendável que FindUser primeiro seja chamado com um nome de logon. O exemplo acima usa essa técnica.

Requisitos

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

Confira também

Objeto DiskQuotaControl