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 |