Metodo DiskQuotaControl.TranslateLogonNameToSID

Articolo
06/13/2023

Converte un nome di accesso nell'ID di sicurezza utente corrispondente in formato stringa.

Sintassi

DiskQuotaControl.TranslateLogonNameToSID(
  logonname
)

Parametri

logonname

Tipo: String

Valore stringa che specifica il nome di accesso dell'utente.

Valore restituito

Restituisce l'ID di sicurezza utente (SID) in formato stringa corrispondente al nome di accesso specificato. La stringa restituita include le parentesi graffe di inclusione standard. Ad esempio:

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

Commenti

La stringa SID restituita può essere passata al metodo FindUser al posto di un nome di accesso.

Quando una chiamata al metodo FindUser( logonname) ha esito negativo, potrebbe verificarsi una mancata corrispondenza tra il modulo (ad esempio, Security Account Manager [SAM] compatible e User Principal Name [UPN]) del nome di accesso specificato e il modulo archiviato nella cache siD-name. In questi casi, il nome di accesso può essere convertito in un SID e la chiamata a FindUser ripetuta. FindUser riconosce una stringa SID e ignora la ricerca della cache SID-name. Il codice di Microsoft Visual Basic Scripting Edition (VBScript) seguente illustra questa tecnica.

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 conversione da nome a SID può essere un processo lento rispetto alle ricerche nella cache dei nomi SID. È quindi consigliabile chiamare prima FindUser con un nome di accesso. Nell'esempio precedente viene usata questa tecnica.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
DLL	Shell32.dll (versione 5.0 o successiva)

Vedi anche

Oggetto DiskQuotaControl

Condividi tramite