Active Directory Service Interface

Active Directory Service Interface (ADSI) 是一组植基于 COM 技术上的应用程式开发介面，程式开发人员可以利用这些介面来连接并存取 Active Directory，并执行查询，更新或删除等管理功能，ADSI同时可支援以LDAP（轻量级目录存取协定）为主的目录服务（例如Novell Directory Service），以及以 Windows NT 网域为主所组成的 WinNT 网域目录。
介面结构.
ADSI 由 COM 以及原生函式库所组成，并封装在 activeds.dll 档案中，部份则被封装在 advaip32.dll 中，以 COM 原生介面方式呈现，以提供给 C/C++ 程式语言透过 COM 介面来取用，不过由于所有的原生介面均支援 COM Automation，因此 Visual Basic 或是 .NET Framework 的语言也可以利用 COM Interop 能力存取 ADSI 中的介面。
原生介面 (Native interfaces).
activeds.dll 中封装了几个 ADSI 中最核心的介面：
activeds.dll 亦提供了几个依物件不同而实作的介面，像是：
在使用 ADSI 之时，有时会需要一些工具型功能，像是 DOMAIN\user 和 User Principal Name 间的转换，或是取得系统资讯等，ADSI 也提供了这类的介面：
这些介面多是使用 C/C++ 程式语言来存取，若是使用 VB 或是 Scripting Language 时，则可以使用另外的方法来存取。
<syntaxhighlight lang="vb">
' Get user object from Active Directory.
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:
</syntaxhighlight>
<syntaxhighlight lang="cpp">
// binding Active Directory using C++ and native interface.
IADs *pObject;
HRESULT hr;
// Initialize COM.
CoInitialize(NULL);
hr = ADsGetObject(L"LDAP://CN=jeffsmith,DC=fabrikam,DC=com", 
if(SUCCEEDED(hr))
// Uninitialize COM.
CoUninitialize();
</syntaxhighlight>
函式.
ADSI 除了介面以外，也将部份功能使用函式方式显露，以简化呼叫原生介面需要处理的工作，较重要且经常被使用的有：
下列的例子，是使用 ADsOpenDSObject() 取得 IADs 物件的范例程式码：
<syntaxhighlight lang="cpp">
IADs *pObject;
LPWSTR szUsername = NULL;
LPWSTR szPassword = NULL
HRESULT hr;
// Insert code to securely retrieve the username and password.
hr = ADsOpenObject(L"LDAP://CN=Jeff,DC=Fabrikam,DC=com",
</syntaxhighlight>
.NET Framework 原生介面.
在 .NET Framework 中，另外提供了一个 .NET 专用的 ADSI 介面程式库 System.DirectoryService.dll，程式开发人员可以加入此程式库的参考来取得 ADSI 的功能，在这个原生类别库中，封装了两个类别，作为存取 Active Directory 的入口之用。
截至 .NET Framework 3.5 为止，ADSI 在 Managed Class Library 中有四个命名空间：
下列为使用 C# 存取 DirectoryEntry 的范例程式码：
<syntaxhighlight lang="csharp">
DirectoryEntry ent = new DirectoryEntry();
DirectoryEntry ou = ent.Children.Find("OU=Consulting");
// Use the Add method to add a user to an organizational unit.
DirectoryEntry usr = ou.Children.Add("CN=New User","user");
// Set the samAccountName, then commit changes to the directory.
usr.Properties["samAccountName"].Value = "newuser"; 
usr.CommitChanges();
</syntaxhighlight>
目录服务提供者 (directory service provider).
ADSI 因为是使用了 LDAP 以及开放式目录等标准，因此只要目录服务的平台是以开放式目录标准实作 IADsNamespace 与其他目录服务提供者介面时，即可由 ADSI 来支援，目前 ADSI 有五种提供者：
OLE DB Provider for Directory Services.
除了 ADSI 原生介面外，微软也为了 SQL Server 或是 ADO 应用程式开发人员发展了可使用 ADO 来存取 Active Directory 的驱动程式，此驱动程式使用 OLE DB 来开发，并且使用类似 SQL 指令的方式来存取 Active Directory，此驱动程式称为 OLE DB Provider for Directory Service，其 COM 的 Prog ID 为 ADsDSOObject。
下例为使用 ADO 存取 Active Directory 的范例程式码：
<syntaxhighlight lang="vb">
Dim Con As New Connection
Dim rs As New Recordset
Dim command As New Command
Dim usr As IADsUser
' Replace department for all users in OU=sales.
Set con = Server.CreateObject("ADODB.Connection")
con.Provider = "ADsDSOObject"
Set command = CreateObject("ADODB.Command")
Set command.ActiveConnection = con
command.CommandText = "SELECT AdsPath, cn FROM 'LDAP://OU=Sales,DC=Fabrikam,DC=com' WHERE objectClass = 'user'"
command.Properties("searchscope") = ADS_SCOPE_ONELEVEL
Set rs = command.Execute
While Not rs.EOF
Wend
</syntaxhighlight>
下列指令为使用 SQL Server 查询来合并存取 Active Directory 的指令码：
<syntaxhighlight lang="sql">
-- create a linked server to active directory interface
EXEC sp_addlinkedserver 'ADSI', 'Active Directory Services 2.5', 'ADSDSOObject', 'adsdatasource' 
-- configure SQL Server to allow ad-hoc query and openquery statement.
EXEC sp_configure 'show advanced options', 1
reconfigure with override
EXEC sp_configure 'Ad Hoc Distributed Queries', 1 
reconfigure 
-- execute query via OpenQuery() statement
SELECT * FROM OpenQuery(ADSI, 'SELECT * FROM "LDAP://DC=kodyaz,DC=com" WHERE objectCategory="user" ') 
SELECT * FROM OpenQuery(ADSI, 'SELECT mail, displayName, userPrincipalName FROM "LDAP://DC=kodyaz,DC=com" WHERE objectCategory="user" ') 
</syntaxhighlight>
开发 Directory-Enabled 应用程式时可用的工具.
由于 ADSI 和 Active Directory 的特性，开发人员若没有使用适当的工具时，很难发展与目录服务连结 (directory-enabled) 的应用程式，因此微软为 Active Directory 提供了两种工具：
参考资料.
内容参考：
文章参考：