Share via

QUERYFORCONNECTION (Windows CE 5.0)

  • Article

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.