The ldap_simple_bind functionasynchronously authenticates a client to a server, using a plaintext password.
WINLDAPAPI ULONG LDAPAPI ldap_simple_bind( LDAP *ld, const PSTR dn, const PSTR passwd );
The session handle.
The name of the user to bind as. The bind operation uses the dn and passwd parameters to authenticate the user.
The password of the user specified in the dn parameter.
If the function succeeds, it returns the message ID of the operation initiated.
If the function fails, it returns -1 and sets the session error parameters in the LDAP data structure.
The ldap_simple_bind function initiates a simple asynchronous bind operation to authenticate a client to an LDAP server. Subsequent bind calls can be used to reauthenticate using the same connection.
To authenticate as a specific user, provide both the name of the entry (user) and the password for that entry. To authenticate an anonymous user, when no access permissions are required, pass NULL to both the dn and passwd parameters.
As an asynchronous function, ldap_simple_bind returns a message ID for the operation. Call ldap_result with the message ID to get the result of the operation. To cancel an asynchronous bind operation before it has completed, call ldap_abandon. Be aware that if an LDAP 2 server is contacted, do not attempt other operations over the connection until the bind call has successfully completed.
To return the results directly, use the synchronous routine ldap_simple_bind_s.
Multithreading: 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.
The ldap_simple_bind function is designed to bind to the local domain. The function cannot be used for cross forest authentication.
|Minimum supported client||Windows Vista|
|Minimum supported server||Windows Server 2008|