Función ADsGetObject (adshlp.h)

La función ADsGetObject se enlaza a un objeto dado su ruta de acceso y un identificador de interfaz especificado.

Sintaxis

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

Parámetros

[in] lpszPathName

Tipo: LPCWSTR

Cadena Unicode terminada en null que especifica la ruta de acceso utilizada para enlazar al objeto en el servicio de directorio subyacente. Para obtener más información y ejemplos de código para enlazar cadenas para este parámetro, vea LDAP ADsPath y WinNT ADsPath.

[in] riid

Tipo: REFIID

Identificador de interfaz de una interfaz especificada en este objeto.

[out] ppObject

Tipo: VOID**

Puntero a un puntero a la interfaz solicitada.

Valor devuelto

Tipo: HRESULT

Este método admite los valores devueltos HRESULT estándar, así como los siguientes.

Para obtener más información sobre otros valores devueltos, consulta Códigos de error ADSI.

Comentarios

Un cliente de C/C++ llama a la función auxiliar ADsGetObject para enlazar a un objeto ADSI. Equivale a un cliente de Visual Basic que llama a la función GetObject . Ambos toman ADsPath como entrada y devuelven un puntero a la interfaz solicitada. De forma predeterminada, el enlace usa ADS_SECURE_AUTHENTICATION opción con el contexto de seguridad del subproceso que realiza la llamada. Sin embargo, si se produce un error en la autenticación, el enlace seguro se degrada a un enlace anónimo, por ejemplo, un enlace simple sin credenciales de usuario. Para enlazar de forma segura a un objeto ADSI, use la función ADsOpenObject en lugar de la función ADsGetObject .

Para obtener un ejemplo de código que muestra cómo usar ADsOpenObject, vea Enlace con GetObject y ADsGetObject.

Es posible enlazar a un objeto ADSI con una credencial de usuario diferente a la del usuario que ha iniciado sesión actualmente. Para realizar esta operación, use la función ADsOpenObject .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	adshlp.h
Library	Activeds.lib
Archivo DLL	Activeds.dll

Consulte también

Códigos de error adsi

Funciones ADSI

ADsOpenObject

Enlace con GetObject y ADsGetObject