Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function establishes a session with a Lightweight Directory Access Protocol (LDAP) server over a connectionless User Datagram Protocol (UDP) service.

Syntax 

LDAP* cldap_open(
  UNICODE PTCHAR 
HostName,
  ULONG 
PortNumber
);

Parameters

HostName

[in] List of host names or dotted strings representing the IP address of LDAP server hosts. Use a single space to separate the host names in the list. Each host name in the list may be followed by a port number. The optional port number is separated from the host itself with a colon (:) character. The LDAP run time attempts connection with the hosts in the order listed, stopping when a successful connection is made.

PortNumber

[in] Contains a host's port number. If no port number is specified, the default is port 389. If a host includes a port number, this parameter is ignored.

Return Value

If this function succeeds, the return value is a session handle, in the form of a pointer to an LDAP structure.

If this function fails, the return value is NULL. To retrieve the error code, call LdapGetLastErroror GetLastError.

Remarks

This function, unlike ldap_open, creates a connection block for UDP-based connectionless LDAP services. No TCP session is maintained. Like ldap_open, this function allocates an LDAP structure to maintain state information for the session and then attempts to make the connection before returning to the caller. The call returns a session handle, which you pass to subsequent LDAP function calls in the course of the session.

In a multithreading environment, calls to this function are thread-safe.

Requirements

Header winldap.h
Library wldap32.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ldap_open