Share via

LDAP_REFERRAL_CALLBACK (Windows Embedded CE 6.0)

  • Article

1/6/2010

This structure is used to implement external caching of connections.

Syntax

typedef struct LdapReferralCallback {
  ULONG SizeOfCallbacks;
  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

Header winldap.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

LDAP Structures
ldap_set_option
NOTIFYOFNEWCONNECTION
QUERYFORCONNECTION