Condividi tramite


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