Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This structure is used to implement external caching of connections.
typedef struct LdapReferralCallback {ULONGSizeOfCallbacks;QUERYFORCONNECTION* QueryForConnection;NOTIFYOFNEWCONNECTION* NotifyRoutine;DEREFERENCECONNECTION* DereferenceRoutine;} LDAP_REFERRAL_CALLBACK, *PLDAP_REFERRAL_CALLBACK;
Members
- SizeOfCallbacks
Specifies the amount of memory needed for the callback mechanism. Set this field to sizeof(LDAP_REFERRAL_CALLBACK). - QueryForConnection
Pointer to a callback function to determine whether there is a cached connection available. - NotifyRoutine
Pointer to a callback function that determines whether a newly created connection will be cached or destroyed after the operation has been completed. - DereferenceRoutine
Pointer to a callback function to dereference a connection that is not in use.
Remarks
Use this structure to implement a mechanism for caching connections. The following table shows possible callback functions for the structure that you can implement in your client code.
| Callback function | Description |
|---|---|
| DEREFERENCECONNECTION | Called by the run time to dereference a connection that is no longer needed. |
| QUERYCLIENTCERT | Allows the server to request a certificate when establishing a Secure Sockets Layer (SSL) connection. |
| QUERYFORCONNECTION | Determines if there is a cached connection available for use. |
| NOTIFYOFNEWCONNECTION | Called by the run time if a new connection was created in the course of chasing a referral to a cached function. |
| VERIFYSERVERCERT | Passes a certificate from the server to the client. |
To configure a session to use callbacks to obtain a cached connection, call ldap_set_option (conn, LDAP_OPT_REFERRAL_CALLBACK, &referralRoutines), where referralRoutines is the address of the LDAP_REFERRAL_CALLBACK structure that contains your routines. The addresses may be NULL, in which case the LDAP run time will not make the calls.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Winldap.h.
See Also
ldap_set_option | NOTIFYOFNEWCONNECTION | QUERYFORCONNECTION
Send Feedback on this topic to the authors