Методы свойств IADs

Статья
06/03/2023

Методы свойств интерфейса IADs получают или задают свойства, описанные в следующей таблице. Дополнительные сведения о методах свойств см. в разделе Методы свойств интерфейса.

Свойства

ADsPath

Тип доступа: только для чтения
Тип данных скрипта: BSTR
// C++ method syntax HRESULT get_ADsPath( [out] BSTR* pbstrADsPath );

Класс

Тип доступа: только для чтения
Тип данных скрипта: BSTR
// C++ method syntax HRESULT get_Class( [out] BSTR* pbstrClass );

GUID

Тип доступа: только для чтения
Тип данных скрипта: BSTR
// C++ method syntax HRESULT get_GUID( [out] BSTR* pbstrGUID );

имя;

Тип доступа: только для чтения
Тип данных скрипта: BSTR
// C++ method syntax HRESULT get_Name( [out] BSTR* pbstrName );

Parent

Тип доступа: только для чтения
Тип данных скрипта: BSTR
// C++ method syntax HRESULT get_Parent( [out] BSTR* pbstrParent );

Схема

Тип доступа: только для чтения
Тип данных скрипта: BSTR
// C++ method syntax HRESULT get_Schema( [out] BSTR* pbstrSchema );

В Active Directory GUID , возвращаемый из GUID, представляет собой строку шестнадцатеричных значений. Используйте результирующий GUID для непосредственной привязки к объекту .

Dim x As IADs
Set x = GetObject("LDAP://servername/<GUID=xxx>")

где xxx — значение, возвращаемое свойством GUID. Дополнительные сведения см. в разделе Использование objectGUID для привязки к объекту. Имейте в виду, что при использовании GUID для привязки к объекту метод свойства ADsPath возвращает значения, отличающиеся от обычных значений, возвращаемых при использовании различающегося имени (DN) для привязки к тому же объекту. Например, в следующей таблице перечислены значения, возвращаемые при использовании двух разных методов привязки для привязки к одному и тому же объекту пользователя.

	Привязка с помощью DN	Привязка с помощью GUID
имя;	CN=Джефф Смит	CN=Джефф Смит
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 в немного другом строковом формате.

Примеры

В следующем примере кода показано, как получить данные объекта с помощью методов свойств интерфейса IAD.

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

В следующем примере кода показано, как получить данные объекта с помощью методов свойств интерфейса IAD.

<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
Заголовок	Iads.h
DLL	Activeds.dll
IID	IID_IADs определяется как FD8256D0-FD15-11CE-ABC4-02608C9E7553

См. также раздел

IAD
IADsContainer

Методы свойств IADs

Свойства

Комментарии

Примеры

Требования

См. также раздел

Обратная связь

Обратная связь

Дополнительные ресурсы