接口属性方法

许多 ADSI 接口旨在支持自动化,因此是双重接口,因为它们支持通过 IUnknownIDispatch 接口进行客户端访问。 非自动化客户端(例如用 C/C++ 编写的客户端)使用 IUnknown::QueryInterface 方法直接解析方法调用,并直接调用 方法。 自动化客户端(也称为名称绑定客户端,如在 Visual Basic 或 Visual Basic Scripting Edition (VBScript) 中编写的客户端)必须使用 dispinterface 方法间接解析方法调用。

支持自动化的 ADSI 接口定义属性方法,用于检索和修改实现接口的对象的属性。 属性方法的名称在适当的属性名称前面附加了 get_ 和 put_,例如 ,get_Userput_Name

每个 get_ 方法都采用单个参数作为输出。 此参数是属性数据类型的变量的方法分配地址。 返回时,此变量假定所请求属性的当前值。 当不再需要 属性时,调用方必须释放变量的分配内存。

每个 put_ 方法都采用单个参数作为相应属性的数据类型的输入。 参数包含 属性的新值。

下面的代码示例演示调用属性方法,这些方法遵循调用对象的成员函数的常规过程。

IADs *pADs;
BSTR bstrName;
pADs->get_Name(&bstrName);

下面的代码示例演示自动化客户端中属性方法的调用,这些方法可能稍有不同。 例如,Visual Basic 使用点表示法。

Dim Obj As IADs
Dim objName As String
objName = Obj.Name

所有参数和返回类型都必须是 VARIANT 数据类型定义的参数和返回类型。 双接口上的所有方法都返回一个 HRESULT 值,指示成功或失败。

有关获取和设置 ADSI 对象的属性的详细信息,请参阅 属性缓存