Interfaccia IADsUser (iads.h)

L'interfaccia IADsUser è un'interfaccia doppia che eredita dagli ID. È progettato per rappresentare e gestire un account utente finale in una rete. Chiamare i metodi di questa interfaccia per accedere e modificare i dati dell'account utente finale. Tali dati includono nomi dell'utente, dei numeri di telefono, del titolo di lavoro e così via. Questa interfaccia supporta le funzionalità per determinare l'associazione di gruppo dell'utente e per impostare o modificare la password.

Per eseguire l'associazione a un utente di dominio tramite un provider WinNT, usare il nome di dominio come parte di ADsPath, come illustrato nell'esempio di codice seguente.

GetObject("WinNT://MYDOMAIN/jeffsmith,user")

Analogamente, usare il nome del computer come parte di ADsPath per eseguire l'associazione a un utente locale.

GetObject("WinNT://MYCOMPUTER/jeffsmith,user")

In Active Directory gli utenti di dominio risiedono nella directory. Nell'esempio di codice seguente viene illustrato come eseguire l'associazione a un utente di dominio tramite un provider LDAP.

GetObject("LDAP://CN=Jeff Smith,OU=Sales,DC=Fabrikam,DC=Com")

Tuttavia, gli account locali risiedono nel database SAM locale e il provider LDAP non comunica con il database locale. Di conseguenza, per eseguire l'associazione a un utente locale, è necessario passare attraverso un provider WinNT come descritto nel secondo esempio di codice.

Ereditarietà

L'interfaccia IADsUser eredita da IDispatch e ID. IADsUser include anche questi tipi di membri:

Metodi

L'interfaccia IADsUser include questi metodi.

IADsUser::ChangePassword Modifica la password utente dal valore precedente specificato a un nuovo valore.
IADsUser::Groups Ottiene una raccolta di oggetti gruppo ADSI a cui appartiene l'utente.
IADsUser::SetPassword Imposta la password utente su un valore specificato.

Commenti

Come per qualsiasi altro oggetto ADSI, l'oggetto contenitore crea un oggetto account utente di Windows. Per prima cosa, eseguire l'associazione a un oggetto contenitore. Chiamare quindi il metodo IADsContainer::Create e specificare attributi obbligatori o facoltativi.

Con WinNT non è necessario specificare attributi aggiuntivi durante la creazione di un utente. È possibile chiamare il metodo IADsContainer::Create per creare direttamente l'oggetto utente.

Dim dom As IADsContainer
Dim usr As IADsUser

On Error GoTo Cleanup

Set dom = GetObject("WinNT://MyDomain")
Set usr = dom.Create("user","jeffsmith")
usr.SetInfo

Cleanup:
    If(Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set mach = Nothing
    Set usr = Nothing

In questo caso, viene creato un utente di dominio con i valori predefiniti seguenti.

Proprietà	Valore
Nome completo	Nome account SAM (ad esempio jeffsmith)
Password	Empty
L'utente deve modificare la password	TRUE
L'utente non può modificare la password	FALSE
Password mai scaduta	FALSE
Account disabilitato	FALSE
Gruppo	Utente del dominio
Profilo	Empty
L'account non scade mai	TRUE

 

Per creare un utente locale, eseguire l'associazione a un computer di destinazione, come illustrato nell'esempio di codice seguente.

Dim mach As IADsContainer
Dim usr as IADsUser

On Error GoTo Cleanup
Set mach = GetObject("WinNT://MyMachine,Computer")
Set usr = mach.Create("user","jeffsmith")
usr.SetInfo

Cleanup:
    If(Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set mach = Nothing
    Set usr = Nothing

L'utente locale appena creato avrà le stesse proprietà predefinite dell'utente di dominio. L'appartenenza al gruppo, tuttavia, sarà "utenti", anziché "utente di dominio".

Requisiti

Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	iads.h

Vedi anche

ID

IADsContainer::Create

Metodi di proprietà IADsUser

Idispatch