Métodos de propriedade IADs

Artigo
06/12/2023

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

Tipo de acesso: Somente leitura
Tipo de dados de script: BSTR
// C++ method syntax HRESULT get_ADsPath( [out] BSTR* pbstrADsPath );

Classe

Tipo de acesso: Somente leitura
Tipo de dados de script: BSTR
// C++ method syntax HRESULT get_Class( [out] BSTR* pbstrClass );

GUID

Tipo de acesso: Somente leitura
Tipo de dados de script: BSTR
// C++ method syntax HRESULT get_GUID( [out] BSTR* pbstrGUID );

Nome

Tipo de acesso: Somente leitura
Tipo de dados de script: BSTR
// C++ method syntax HRESULT get_Name( [out] BSTR* pbstrName );

Pai

Tipo de acesso: Somente leitura
Tipo de dados de script: BSTR
// C++ method syntax HRESULT get_Parent( [out] BSTR* pbstrParent );

Esquema

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

Compartilhar via

Métodos de propriedade IADs

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais