Windows XP Windows 7 Windows 2003 Windows Vista Windows教程綜合 Linux 系統教程
Windows 10 Windows 8 Windows 2008 Windows NT Windows Server 電腦軟件教程
 Windows教程網 >> Windows Server系統教程 >> Windows Server教程 >> Delphi深度探索-活動目錄設計

Delphi深度探索-活動目錄設計

日期:2017/1/24 11:02:21      編輯:Windows Server教程


活動目錄是 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 的活動目錄編程參考就有上千頁,說明我們必須花費大量時間才能真正掌握它的精髓。

 
Copyright © Windows教程網 All Rights Reserved