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

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

Свойства

ADsPath

Строка ADsPath этого объекта. Строка однозначно идентифицирует этот объект в сетевой среде. Объект всегда можно получить с помощью этого пути.

Тип доступа: только для чтения

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_ADsPath(
  [out] BSTR* pbstrADsPath
);

Класс

Имя класса object Schema.

Тип доступа: только для чтения

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Class(
  [out] BSTR* pbstrClass
);

GUID

Глобальный уникальный идентификатор объекта каталога. Интерфейс IADs преобразует GUID из строки октета, хранящейся на сервере каталогов, в строковый формат.

Тип доступа: только для чтения

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_GUID(
  [out] BSTR* pbstrGUID
);

Имя

Относительное имя объекта, именованного в базовой службе каталогов. Это имя отличает этот объект от его братьев и сестер.

Тип доступа: только для чтения

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Name(
  [out] BSTR* pbstrName
);

Parent

Строка ADsPath родительского контейнера. Active Directory не разрешает формирование ADsPath заданного объекта путем объединения свойств Parent и Name . Хотя эта операция может работать в некоторых поставщиках, она не гарантируется для всех реализаций. ADsPath гарантированно является допустимым и всегда должен использоваться для получения указателя интерфейса объекта.

Тип доступа: только для чтения

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Parent(
  [out] BSTR* pbstrParent
);

Схема

Строка ADsPath объекта класса Schema этого объекта.

Тип доступа: только для чтения

Тип данных скрипта: BSTR

// C++ method syntax
HRESULT get_Schema(
  [out] BSTR* pbstrSchema
);

Remarks

В 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 Смит,CN=Users,DC=Fabrikam,DC=com <LDAP://server/ GUID=c0f59dfcf507d31a99e000f879f7c7>

Примечание

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

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

Идентификаторы IAD

IADsContainer