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 |