Métodos de propriedade IADs

  • Artigo

Os métodos de propriedade da interface IADs obtêm ou definem as propriedades descritas na tabela a seguir. Para obter mais informações sobre métodos de propriedade, consulte Métodos de propriedade de interface.

Propriedades

Adspath

A cadeia de caracteres ADsPath desse objeto. A cadeia de caracteres identifica exclusivamente esse objeto em um ambiente de rede. O objeto sempre pode ser recuperado usando esse caminho.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

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

Classe

O nome da classe Schema do objeto.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

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

GUID

O identificador global exclusivo do objeto de diretório. A interface IADs converte o GUID de uma cadeia de caracteres de octeto, conforme armazenado em um servidor de diretório, em um formato de cadeia de caracteres.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

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

Nome

O nome relativo do objeto, conforme nomeado no serviço de diretório subjacente. Esse nome distingue esse objeto de seus irmãos.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

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

Pai

A cadeia de caracteres ADsPath do contêiner pai. O Active Directory não permite a formação do ADsPath de um determinado objeto concatenando as propriedades Parent e Name . Embora essa operação possa funcionar em alguns provedores, não há garantia de que ela funcione para todas as implementações. O ADsPath tem a garantia de ser válido e sempre deve ser usado para recuperar o ponteiro de interface de um objeto.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

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

Esquema

A cadeia de caracteres ADsPath do objeto da classe Schema desse objeto .

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

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

Comentários

No Active Directory, o GUID retornado do GUID é uma cadeia de caracteres de hexadecimals. Use o GUID resultante para associar ao objeto diretamente.

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

em que xxx é o valor retornado da propriedade GUID. Para obter mais informações, consulte Usando objectGUID para associar a um objeto. Lembre-se de que, se você usar um GUID para associar a um objeto , o método de propriedade ADsPath retornará valores diferentes dos valores normais que seriam retornados se você usasse um DN (nome diferenciado) para associar ao mesmo objeto. Por exemplo, a tabela a seguir lista os valores retornados ao usar os dois métodos de associação diferentes para associar ao mesmo objeto de usuário.

Associar usando DN Associar usando GUID
Nome CN=Jeff Smith CN=Jeff Smith
Pai 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>

Observação

O provedor WinNT não dá suporte à associação usando o GUID do objeto e retorna a propriedade GUID em um formato de cadeia de caracteres ligeiramente diferente.

Exemplos

O exemplo de código a seguir mostra como recuperar dados de objeto usando métodos de propriedade da interface 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

O exemplo de código a seguir mostra como recuperar dados de objeto usando métodos de propriedade da interface 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>

O exemplo de código a seguir mostra como trabalhar com os métodos de propriedade da interface 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;
    }
}

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Cabeçalho
Iads.h
DLL
Activeds.dll
IID
 IID_IADs é definido como FD8256D0-FD15-11CE-ABC4-02608C9E7553

Confira também

Iads

IADsContainer