IADs 属性方法
IADs 接口的属性方法获取或设置下表中所述的属性。 有关属性方法的详细信息,请参阅 Interface 属性方法。
属性
-
ADsPath
-
-
访问类型:只读
-
脚本数据类型: BSTR
-
// C++ method syntax HRESULT get_ADsPath( [out] BSTR* pbstrADsPath );
此对象的 ADsPath 字符串。 字符串在网络环境中唯一标识此对象。 始终可以使用此路径检索对象。
-
-
类
-
-
访问类型:只读
-
脚本数据类型: BSTR
-
// C++ method syntax HRESULT get_Class( [out] BSTR* pbstrClass );
对象 Schema 类的名称。
-
-
GUID
-
-
访问类型:只读
-
脚本数据类型: BSTR
-
// C++ method syntax HRESULT get_GUID( [out] BSTR* pbstrGUID );
目录对象的全局唯一标识符。 IADs 接口将 GUID 从八进制字符串(存储在目录服务器上)转换为字符串格式。
-
-
Name
-
-
访问类型:只读
-
脚本数据类型: BSTR
-
// C++ method syntax HRESULT get_Name( [out] BSTR* pbstrName );
在基础目录服务中命名的对象相对名称。 此名称将此对象与其同级区分开来。
-
-
Parent
-
-
访问类型:只读
-
脚本数据类型: BSTR
-
// C++ method syntax HRESULT get_Parent( [out] BSTR* pbstrParent );
父容器的 ADsPath 字符串。 Active Directory 不允许通过连接 Parent 和 Name 属性来形成给定对象的 ADsPath。 虽然此操作在某些提供程序中可能正常工作,但不能保证适用于所有实现。 ADsPath 保证有效,应始终用于检索对象的接口指针。
-
-
架构
-
-
访问类型:只读
-
脚本数据类型: BSTR
-
// C++ method syntax HRESULT get_Schema( [out] BSTR* pbstrSchema );
此对象的 Schema 类对象的 ADsPath 字符串。
-
注解
在 Active Directory 中 ,从 GUID 返回的 GUID 是十六进制字符串。 使用生成的 GUID 直接绑定到对象。
Dim x As IADs
Set x = GetObject("LDAP://servername/<GUID=xxx>")
其中 xxx 是从 GUID 属性返回的值。 有关详细信息,请参阅使用 objectGUID 绑定到对象。 请注意,如果使用 GUID 绑定到对象, ADsPath 属性方法将返回的值与使用可分辨名称(DN)绑定到同一对象的正常值不同。 例如,下表列出了使用两种不同的绑定方法绑定到同一用户对象时返回的值。
使用 DN 绑定 | 使用 GUID 进行绑定 | |
---|---|---|
Name | CN=Jeff Smith | CN=Jeff Smith |
Parent | LDAP://server/CN=Users,DC=Fabrikam,DC=com | LDAP://server/CN=Users,DC=Fabrikam,DC=com |
ADsPath | LDAP://server/CN=Jeff Smith,CN=Users,DC=Fabrikam,DC=com | <LDAP://server/ GUID=c0f59dfcf507d311a99e0000f879f7c7> |
注意
WinNT 提供程序不支持使用对象 GUID 进行绑定,并且以略有不同的字符串格式返回 GUID 属性。
示例
下面的代码示例演示如何使用 IADs 接口的属性方法检索对象数据。
Dim x As IADs
Dim parent As IADsContainer
Dim cls As IADsClass
Dim op As Variant
On Error GoTo Cleanup
Set x = GetObject("WinNT://Fabrikam/Administrator")
Debug.Print "Object Name: " & x.Name
Debug.Print "Object Path: " & x.ADsPath
Debug.Print "Object Class: " & x.Class
' Get more data about the object schema.
Set cls = GetObject(x.Schema)
Debug.Print "Class Name is: " & cls.Name
For Each op In cls.OptionalProperties
Debug.Print "Optional Property: " & op
Next op
Cleanup:
If (Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set x = Nothing
Set parent = Nothing
Set cls = Nothing
下面的代码示例演示如何使用 IADs 接口的属性方法检索对象数据。
<HTML>
<head><title></title></head>
<body>
<%
Dim x
On Error Resume Next
Set x = GetObject("WinNT://Fabrikam/Administrator")
Response.Write "Object Name: " & x.Name & "<br>"
Response.Write "Object Path: " & x.ADsPath & "<br>"
Response.Write "Object Class: " & x.Class & "<br>"
' Get more data about the object schema.
Set cls = GetObject(x.Schema)
Response.Write "Class Name is: " & cls.Name & "<br>"
For Each op In cls.OptionalProperties
Response.Write "Optional Property: " & op & "<br>"
Next op
%>
</body>
</html>
下面的代码示例演示如何使用 IADs 接口的属性方法。
#include <stdio.h>
#include <activeds.h>
int main(int argc, char* argv[])
{
IADs *pADs = NULL;
IADsUser *pADsUser = NULL;
IADsClass *pCls = NULL;
CComBSTR sbstr;
HRESULT hr = CoInitialize(NULL);
if (hr != S_OK) { return 0; }
hr=ADsGetObject(L"WinNT://Fabrikam/Administrator",
IID_IADsUser,
(void**) &pADsUser);
if (hr != S_OK) { goto Cleanup; }
hr = pADsUser->QueryInterface(IID_IADs, (void**) &pADs);
if( hr !=S_OK) { goto Cleanup;}
pADsUser->Release();
if( S_OK == pADs->get_Name(&sbstr) ) {
printf("Object Name: %S\n",sbstr);
}
if( S_OK == pADs->get_ADsPath(&sbstr) ) {
printf("Object path: %S\n",sbstr);
}
if( S_OK == pADs->get_Class(&sbstr) ) {
printf("Object class: %S\n",sbstr);
}
hr = pADs->get_Schema(&sbstr);
if ( hr != S_OK) {goto Cleanup;}
hr = ADsGetObject(sbstr,IID_IADsClass, (void**)&pCls);
if ( hr != S_OK) {goto Cleanup;}
if( S_OK == pCls->get_Name(&sbstr) ) {
printf("Class name is %S\n", sbstr);
}
Cleanup:
if(pADs)
pADs->Release();
if(pIADsUser)
pADsUser->Release();
if(IADsClass)
pADsClass->Release();
CoUninitialize();
if(hr==S_OK)
{
return 1;
}
else
{
return 0;
}
}
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista |
最低受支持的服务器 |
Windows Server 2008 |
标头 |
|
DLL |
|
IID |
IID_IADs定义为 FD8256D0-FD15-11CE-ABC4-02608C9E7553 |