ldap_simple_bind_s
A version of this page is also available for
4/8/2010
This function authenticates a client to a server using a clear text password.
Syntax
ULONG ldap_simple_bind_s(
LDAP* ld,
UNICODE PTCHAR dn,
UNICODE PTCHAR passwd
);
Parameters
- ld
[in] Session handle.
- dn
[in] Distinguished name of the user used to bind. The bind operation uses the dn and passwd parameters to authenticate the user.
- passwd
[in] Password of the user specified in the dn parameter.
Return Value
If this function succeeds, the return value is LDAP_SUCCESS.
If this function fails, it returns an error code. See the LDAP_RETCODE enumeration for a list of possible return values.
Remarks
This function initiates a simple synchronous bind operation to authenticate a client to an LDAP server. Subsequent bind calls can be used to re-authenticate over the same connection.
Upon completion of the bind operation, this function returns to the caller. Use ldap_simple_bind if you prefer to have the operation carried out asynchronously. Note, however, that if an LDAP 2 server is contacted, no other operations over the connection should be attempted before the bind call has successfully completed.
In a multithreading environment, bind calls are not safe because they apply to the connection as a whole. Use caution if threads share connections, and try to thread binds with other operations.
Requirements
| Header | winldap.h |
| Library | wldap32.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |