Método DiskQuotaControl.TranslateLogonNameToSID

Convierte un nombre de inicio de sesión en el identificador de seguridad de usuario correspondiente en formato de cadena.

Sintaxis

DiskQuotaControl.TranslateLogonNameToSID(
  logonname
)

Parámetros

logonname

Tipo: Cadena

Valor de cadena que especifica el nombre de inicio de sesión del usuario.

Valor devuelto

Devuelve el identificador de seguridad de usuario (SID) en formato de cadena correspondiente al nombre de inicio de sesión proporcionado. La cadena devuelta incluye las llaves envolventes estándar. Por ejemplo:

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

Comentarios

La cadena de SID devuelta se puede pasar al método FindUser en lugar de un nombre de inicio de sesión.

Cuando se produce un error en una llamada al método FindUser( logonname), podría deberse a una discrepancia entre el formulario (por ejemplo, administrador de cuentas de seguridad [SAM] compatible y nombre principal de usuario [UPN]) del nombre de inicio de sesión proporcionado y el formulario almacenado en la caché de nombres SID. En tales casos, el nombre de inicio de sesión se puede convertir en un SID y la llamada a FindUser repetida. FindUser reconoce una cadena de SID y omitirá la búsqueda de caché de nombres SID. El siguiente código de Microsoft Visual Basic Scripting Edition (VBScript) ilustra esta 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

La traducción de nombres a SID puede ser un proceso lento en comparación con las búsquedas en la caché de nombres SID. Por lo tanto, se recomienda llamar primero a FindUser con un nombre de inicio de sesión. En el ejemplo anterior se usa esta técnica.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Archivo DLL	Shell32.dll (versión 5.0 o posterior)

Consulte también

DiskQuotaControl (objeto)