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 |