Table of Contents | Previous | Next | Index

Netscape Directory SDK 3.0 for C Programmer’s Guide
Chapter 18 Functions

ldap_memcache_set()

Associates an in-memory cache with an LDAP connection handle.

Syntax

#include <ldap.h>
int ldap_memcache_set( LDAP *ld, LDAPMemCache *cache );

Parameters

This function has the following parameters:

ld
Connection handle, which is a pointer to an LDAP structure containing information about the connection to the LDAP server.

cache
Pointer to an LDAPMemCache structure, which represents the cache that you want used for this connection.

Returns

One of the following values:

LDAP_SUCCESS if the cache was successfully associated with the connection handle.

LDAP_PARAM_ERROR if an invalid parameter was passed to the function

LDAP_SIZELIMIT_EXCEEDED if the size of the cache is too small.

Description

The ldap_memcache_set() function associates a cache that you have created (by calling the ldap_memcache_init() function) with an LDAP connection handle.

After you call this function, search requests made over the specified LDAP connection will use this cache. Note that calling the ldap_unbind() function or the ldap_unbind() function will disassociate the cache from the LDAP connection handle.

You can call this function if you want to associate a cache with multiple LDAP connection handles. For example, you can call the ldap_memcache_get() function to get the cache associated with one connection, then you can call this function associate the cache with another connection.

See Also

ldap_memcache_init(), ldap_memcache_get().

Table of Contents | Previous | Next | Index

Last Updated: 10/01/98 17:06:23