活動目錄是 Windows NT 4.0 和 Windows 2000 使用的目錄服務。要想使用活動目錄服務,需要調用 ADSI( 活動目錄服務接口 ) 。 ADSI 是一組以 COM 接口的形式提供目錄服務的,程序員可以通過 ADSI 存取四種網絡目錄結構: WinNT (Microsoft SAM 數據庫 ) 、 LDAP ( 輕量目錄存取協議 ) 、 NDS (NetWare 目錄服務 ) 和 NWCOMPAT (Novell NetWare 3.x) 。
ADSI 可以使 Windows NT 管理員的工作變得輕松。 ADSI 支持管理員執行一些一般的管理任務,比如添加新用戶、管理打印機、安全設定和控制 NT 域。因為 ADSI 使用 COM 接口,任何支持 COM 的編程語言像 Delphi 、 BCB 、 VB 、 VC 等都可以調用 ADSI 。
圖 1.111
活動目錄運行在 Windows NT 4.0 和 Windows 2000 上。客戶端程序可以運行在 Windows 95 、 Windows 98 、 Windows NT 4.0 和 Windows 2000 上。為了使用 ADSI ,必須安裝 ADSI COM 接口。 ADSI 2.5 SDK 可以從 Microsoft ADSI 網址 http://www.microsoft.com/adsi 下載 。 SDK 包括文檔、在線幫助和很多例子,不過不幸的是這些例子都是針對 VB 和 VC 的,這裡我們將演示如何使用 Delphi 調用 ADSI 。
程序演示
圖 1.111 所示的程序演示了如何調用 WinNT provider 提供的功能。演示程序用來連接到一個域,一旦連接到域,程序將會列出在 PDC 上找到的 NT 的用戶和組以及域中的計算機。同時這個程序還演示了如何察看域中計算機上的服務和察看、添加、刪除 NT 組中的用戶。
使用 ADSI 控制 Windows NT/2000
ADSI 可以使我們控制用戶、組、計算機、文件共享、打印任務、打印隊列和服務等系統資源。要想在 Delphi 中調用 ADSI ,需要引入活動目錄類型庫,調用菜單 Project | Import Type Library 命令,選擇 ActiveDs (Version 1.0) 點確認, Delphi 會生成相應的封裝文件。
綁定 Win NT 目錄服務
連接 Win NT 目錄服務就是找到域控制器然後綁定到相應的對象上。綁定可以通過 ADsGetObject 或 ADsOpenObject 函數來實現。 ADsGetObject 函數聲明如下:
function ADsGetObject(lpszPathName: PWideChar; const riid: TIID; out obj): HResult; stdcall; external 'activeds.dll';
第一個參數是對象的路徑名,第二個參數是對象的接口標識符,第三個參數用於返回得到的被請求的接口指針。缺省條件下,函數根據當前用戶進行安全認證。
ADsOpenObject 函數在不同的安全認證機制下綁定 ADSI 對象,它主要是通過調用參數返回的用戶名和口令來認證的。函數聲明如下:
function ADsOpenObject(lpszPathName: PWideChar; lpszUserName: PWideChar; lpszPassword: PWideChar; dwReserved: LongInt; const riid: TIID; out obj): HResult; stdcall; external 'activeds.dll';
第一個參數意義同上,第二、三個參數是調用者提供的用戶名和口令,第四個參數是一個保留的 provider 標識,用來確定綁定的認證方法,第五個參數是請求接口的接口標識符,最後一個參數用來返回請求的接口指針。
第一個函數使用登錄用戶缺省的信任級別,而第二個函數允許開發者指定特殊的安全信任機制來綁定 ADSI 對象。下面代碼演示了兩種不同的綁定方式:
procedure TMainFrm.actOpenWinNTExecute(Sender: TObject);
var
UnknownObject: IUnknown;
DomainPath: WideString;
Domain: IADsContainer;
begin
// 指定域路徑
DomainPath := 'WinNT://' + ADSIDomainName.Text;
// 如果使用用戶登錄了信息
if cbUseLogin.Checked then
// 使用用戶登錄的信息創建域對象
OleCheck(AdsOpenObject(PWideChar(DomainPath),
PWideChar(ADSIUsername.Text),
PWideChar(ADSIPassword.Text), 0, IID_IADsContainer,
UnknownObject));
else
OleCheck(ADsGetObject(PWideChar(DomainPath),
IID_IADsContainer, UnknownObject));
// 設定域對象
Domain := UnknownObject as IADsContainer;
// 從域中獲得信息列表
GetDomainInformation(Domain);
end;
下面我們需要聲明三個變量 :
第一個是接口變量 , 用來綁定由指定的對象路徑返回的函數。
UnknownObject: IUnknown;
第二個參數是 WideString 類型的變量 , 用來在綁定函數中產生一個對象路徑。
DomainPath: WideString;
第三是一個 IADsContainer 接口類型變量 , 用來保存返回的接口變量。
Domain: IADsContainer;
IADsContainer 變量將被用來從指定的 ADSI 對象中獲得全部用戶、組和計算機。當然也可以使用 IADsDomain 類型的變量,但它不適合枚舉域中的子對象。
下面指定想要獲得的對象路徑 , 如果域名是 "PRISMA" , 要想獲得 ADSI 對象 , 就需要指定路徑為 "WinNT://PRISMA" :
// 設定域名路徑
DomainPath := 'WinNT://' + ADSIDomainName.Text;
下面代碼使用不同的安全認證方式:
// 如果使用登錄信息
if cbUseLogin.Checked then
// 使用登錄並創建域對象
OleCheck(AdsOpenObject(PWideChar(DomainPath),
PWideChar(ADSIUsername.Text),
PWideChar(ADSIPassword.Text), 0, IID_IADsContainer,
UnknownObject));
else
// 創建域對象
OleCheck(ADsGetObject(PWideChar(DomainPath),
IID_IADsContainer, UnknownObject));
然後我們獲取 IADsContainer 指針,以便查詢域中的子對象:
// 獲取域對象
Domain := UnknownObject as IADsContainer;
最後 , 把 IADsContainer 接口指針作為參數調用來獲得域中的子對象 :
GetDomainInformation(Domain);
在域中查找
要想在域中查找子對象 , 可以使用 GetDomainInformation 過程 , 代碼如下 :
// 獲取域信息
procedure TMainFrm.GetDomainInformation(
Domain: IADsContainer);
var
Enum: IEnumVariant;
ADsTempObj: OLEVariant;
ADsObj: IADs;
Value: LongWord;
begin
// 清空用戶、組和計算機列表
UserListView.Items.Clear;
GroupListView.Items.Clear;
ComputerListView.Items.Clear;
// 獲取枚舉對象
Enum := (Domain._NewEnum) as IEnumVariant;
// 利用枚舉對象查找
while (Enum.Next(1, ADsTempObj, Value) = S_OK) do begin
// 獲得臨時對象
ADsObj := IUnknown(ADsTempObj) as IADs;
// 如果是用戶對象
if AdsObj.Class_ = 'User' then
AddUserToList(ADsObj);
// 如果是組對象
if AdsObj.Class_ = 'Group' then
AddGroupToList(ADsObj);
// 如果是計算機對象
if AdsObj.Class_ = 'Computer' then
AddComputerToList(ADsObj);
end;
end;
下面是對程序流程的詳細說明,首先獲得枚舉對象,並賦值給 Enum 變量:
Enum := (Domain._NewEnum) as IEnumVariant;
然後利用枚舉變量進行查找並把每個子對象賦值給臨時的 OLEVariant 對象:
while (Enum.Next(1, ADsTempObj, Value) = S_OK) do begin
OLEVariant 變量賦值給 ADSI 對象
ADsObj := IUnknown(ADsTempObj) as IADs;
獲得 ADSI 對象後,開始檢查對象類,根據對象類別把 ADSI 分別處理,並把不同 ADSI 對象的屬性添加到各自的列表視圖中去:
// 如果是用戶對象
if AdsObj.Class_ = 'User' then
AddUserToList(ADsObj);
// 如果是組對象
if AdsObj.Class_ = 'Group' then
AddGroupToList(ADsObj);
// 如果是計算機對象
圖 1.112
if AdsObj.Class_ = 'Computer' then AddComputerToList(ADsObj);
運行結果如 圖 1.112 所示。
創建或刪除計算機用戶
通過 WinNT provider ,可以創建或刪除域中任意一台計算機的用戶,要想創建一個域中指定的計算機的用戶,需要綁定到指定的計算機上。一旦要綁定到計算機對應的 ADSI 容器對象,就需要調用 Create 方法。容器對象的 Create 方法需要兩個參數,一個是要創建的 ADSI 對象的類別,一個是要用來描述 ADSI 對象的名字。調用 Create 方法後會返回新的 ADSI 對象的引用參考,下面代碼演示了如何創建一個用戶:
var
ComputerObj: IADsContainer;
TempUserObj: IUnknown;
UserObj: IADsUser;
PDCName: WideString;
NewUserName: WideString;
AdsPath: WideString;
begin
// 獲取用戶信息
PDCName := InputBox(' 創建新用戶 ', ' 請輸入域名 : ', '');
NewUserName := InputBox(' 創建新用戶 ', ' 請輸入用戶名 : ', '');
// 指定域名路徑
AdsPath := 'WinNT://' + PDCName + ',computer';
// 創建計算機對象
OleCheck(AdsGetObject(PWideChar(AdsPath),
IID_IADsContainer, ComputerObj));
// 創建新用戶
TempUserObj := ComputerObj.Create('user', NewUserName);
UserObj := TempUserObj as IADsUser;
// 設定目錄信息
UserObj.SetInfo;
// 刷新列表
actOpenWinNT.Execute;
刪除用戶也非常類似 , 只不過不需要創建任何的用戶對象 , 可直接調用容器對象 IADsContainer 接口的 Delete 方法 , Delete 方法需要兩個參數 , 第一個是要刪除的對象類別 , 第二個是對象名稱 , 代碼示意如下 :
var
ComputerObj: IADsContainer;
PDCName: WideString;
UserName: WideString;
AdsPath: WideString;
begin
// 獲取用戶信息
PDCName := InputBox(' 刪除用戶 ', ' 請輸入域名 ', '');
UserName := InputBox(' 刪除用戶 ', ' 請輸入要刪除的用戶名 : ', '');
if MessageDlg(' 你是否確信要刪除用戶 : ' +UserName + ' ?', mtConfirmation, [mbYes, mbNo], 0) = mrYes then
begin
// 指定域名路徑
AdsPath := 'WinNT://' + PDCName + ',computer';
// 創建計算機對象
OleCheck(AdsGetObject(PWideChar(AdsPath),
IID_IADsContainer, ComputerObj));
// 刪除用戶
ComputerObj.Delete('user', UserName);
// 刷新列表
actOpenWinNT.Execute;
end;
end
查看組中的用戶
通過 WinNT provider ,我們還可以執行各種用戶組的維護任務,比如從組中添加或刪除用戶。下面就來演示如何枚舉組中的用戶並察看用戶相關信息。首先讓下面代碼獲得一個 IADsGroup 對象,然後使用 IADsMember 對象來枚舉 IADsGroup 對象中所有用戶對象,列出不同組中的所有用戶:
var
GroupObj: IADsGroup;
Members: IADsMembers;
AdsPath: WideString;
Enum: IEnumVariant;
TempUserObj: OLEVariant;
UserObj: IADsUser;
TempListObj: TListItem;
Value: LongWord;
begin
// 清空列表
GroupListView.Items.Clear;
// 指定域名路徑
AdsPath := 'WinNT://' + MainFrm.ADSIDomainName.Text +'/' + GroupName;
// 創建組對象
OLECheck(AdsGetObject(PWideChar(AdsPath), IID_IADsGroup,
GroupObj));
// 獲得 members 對象
Members := GroupObj.Members;
// 獲取枚舉對象
Enum := (Members._NewEnum) as IEnumVariant;
// 使用枚舉對象進行查找
while (Enum.Next(1, TempUserObj, Value) = S_OK) do
try
// 保存臨時對象
UserObj := IUnknown(TempUserObj) as IADsUser;
// 創建新的列表項
TempListObj := GroupListView.Items.Add;
// 指定屬性
TempListObj.Caption := UserObj.Name;
except
on E:Exception do
圖 1.113
end;
IADsGroup 接口是用來管理 NT 組信息的接口,而它的 Members 屬性是一個管理組中用戶或 ADSI 對象列表的接口。最後使用 IADsUser 接口變量 UserObj 來獲得 NT 組中的用戶信息。
程序運行結果如圖 1.113 所示。
控制 NT 服務
WinNT provider 還可以用來控制 NT 服務、服務器和工作站 , 下面的代碼遍歷 NT 服務 , 並根據相應的計算機添加服務到相應列表中 :
var
UnknownObject: IUnknown;
Computer: IADsContainer;
ComputerPath: WideString;
Enum: IEnumVariant;
AdsTempObj: OLEVariant;
AdsObj: IADs;
Value: LongWord;
begin
if Item.Caption = '' then
Exit;
// 指定域名路徑
ComputerPath := 'WinNT://' + ADSIDomainName.Text +'/' + Item.Caption;
// 創建計算機對象
OleCheck(ADsGetObject(PWideChar(ComputerPath),
IID_IADsComputer, UnknownObject));
// 獲得計算機容器接口
Computer := UnknownObject as IADsContainer;
// 清空服務視圖列表
ServiceListView.Items.Clear;
// 獲取枚舉對象用於遍歷
Enum := (Computer._NewEnum) as IEnumVariant;
// 用枚舉對象進行查找
while (Enum.Next(1, ADsTempObj, Value) = S_OK) do begin
// 保存臨時對象
ADsObj := IUnknown(ADsTempObj) as IADs;
// 如果對象為服務的話 ,添加到視圖中
if AdsObj.Class_ = 'Service' then
AddServiceToList(ADsObj);
end;
end.
要想獲得 NT 服務的信息,需要綁定服務對應的 ADSI 對象, ADSI 提供了 IADsService 對象來維護 NT 服務的信息,下面代碼演示了如何綁定 NT 服務,並顯示服務名:
var
ServiceObj: IADsService;
AdsPath: WideString;
begin
// 指定域名路徑
AdsPath := 'WinNT://' + ComputerName + '/' + ServiceName;
// 獲得服務對象
OLECheck(ADsGetObject(PWideChar(AdsPath),
IID_IADsService, ServiceObj));
// 獲得服務名
lblServiceName.Caption := ' 服務名 : ' + ServiceName;
lblDisplayName.Caption := ' 服務顯示名稱 : ' +
ServiceObj.Get_DisplayName;
要想啟動或停止 NT 服務 , 可以使用 IADsServiceOperations ADSI 對象。同上面一樣需要先綁定到 NT 服務上去,而同前面不一樣的是,這回不是獲得 IADsService ADSI 對象,而是獲得 IADsServiceOperations ADSI 對象:
// 創建計算機對象
OleCheck(AdsGetObject(PWideChar(AdsPath),
IID_IADsServiceOperations, Result));
然後使用 GetServiceObj 函數來綁定到 IADsServiceOperations ADSI 對象上 , 並返回 IADsServiceOperations 接口 :
// 獲得服務對象
ServiceObj := GetServiceObj;
啟動服務需要調用 IADsServiceOperations 接口的 Start 方法:
圖 1.114
// 啟動服務 , Get_Status = 1 表明服務正處於停止狀態
if ServiceObj.Get_Status = 1 then
ServiceObj.Start;
要停止服務需要調用 IADsServiceOperations ADSI 對象的 Stop 方法 , 運行結果如圖 1.114 所示。
結論
毫無疑問,通過 ADSI 目錄服務,調用 WinNT provider 可以更容易實現 NT 的管理功能,但它也是一個龐大的系統,光 Windows 的活動目錄編程參考就有上千頁,說明我們必須花費大量時間才能真正掌握它的精髓。