Função ADsGetObject (adshlp.h)

A função ADsGetObject se associa a um objeto dado seu caminho e um identificador de interface especificado.

Sintaxe

HRESULT ADsGetObject(
  [in]  LPCWSTR lpszPathName,
  [in]  REFIID  riid,
  [out] VOID    **ppObject
);

Parâmetros

[in] lpszPathName

Tipo: LPCWSTR

A cadeia de caracteres Unicode terminada em nulo que especifica o caminho usado para associar ao objeto no serviço de diretório subjacente. Para obter mais informações e exemplos de código para cadeias de caracteres de associação para esse parâmetro, consulte LDAP ADsPath e WinNT ADsPath.

[in] riid

Tipo: REFIID

Identificador de interface para uma interface especificada neste objeto.

[out] ppObject

Tipo: VOID**

Ponteiro para um ponteiro para a Interface solicitada.

Retornar valor

Tipo: HRESULT

Esse método dá suporte aos valores de retorno HRESULT padrão, bem como aos seguintes.

Para obter mais informações sobre outros valores retornados, consulte Códigos de erro ADSI.

Comentários

Um cliente C/C++ chama a função auxiliar ADsGetObject para associar a um objeto ADSI. É equivalente a um cliente do Visual Basic que chama a função GetObject . Ambos tomam um ADsPath como entrada e retornam um ponteiro para a interface solicitada. Por padrão, a associação usa ADS_SECURE_AUTHENTICATION opção com o contexto de segurança do thread de chamada. No entanto, se a autenticação falhar, a associação segura será rebaixada para uma associação anônima, por exemplo, uma associação simples sem credenciais de usuário. Para associar com segurança a um objeto ADSI, use a função ADsOpenObject em vez da função ADsGetObject .

Para obter um exemplo de código que mostra como usar ADsOpenObject, consulte Binding With GetObject e ADsGetObject.

É possível associar a um objeto ADSI com uma credencial de usuário diferente daquela do usuário conectado no momento. Para executar essa operação, use a função ADsOpenObject .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	adshlp.h
Biblioteca	Activeds.lib
DLL	Activeds.dll

Confira também

Códigos de erro ADSI

Funções ADSI

ADsOpenObject

Associação com GetObject e ADsGetObject