QUERYFORCONNECTION (Windows CE 5.0)
This callback function is an application-defined function. This client-side function determines whether there is a cached connection available for use. The QUERYFORCONNECTION name for this function is a placeholder for the function name defined by the application.
typedef ULONG (_cdecl QUERYFORCONNECTION)(PLDAPPrimaryConnection,PLDAPReferralFromConnection,
PWCHARNewDN,PCHARHostName,ULONGPortNumber,PVOIDSecAuthIdentity,PVOIDCurrentUserToken,PLDAP* ConnectionToUse);
Parameters
- PrimaryConnection
[in] Specifies the primary connection. - ReferralFromConnection
[in] Specifies the connection, which provided the referral. - NewDN
[in] Specifies the distinguished name (DN) of the desired entry in the referred server. - HostName
[in] Specifies the name of the referred server. - PortNumber
[in] Specifies the port number on which to connect. - SecAuthIdentity
[in] Specifies the credentials to pass to the referred server. If this parameter is NULL, use the CurrentUserToken parameter. - CurrentUserToken
[in] Pointer to the LUID of the current user. - ConnectionToUse
[out] Pointer to the connection to use. This parameter is set to NULL, if there is no connection cached that can be used.
Return Values
The return values are user-defined.
Remarks
If a connection is available, this function should return a pointer to the connection to use in the ConnectionToUse parameter. If no connection is available, the function should set the ConnectionToUse parameter to NULL.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Winldap.h.
Link Library: Wldap32.lib.
Send Feedback on this topic to the authors