Registers an array of keys for getting updates from the server. Valid only for a Native Client region when client notification ( SetClientNotificationEnabled(Boolean) ) is true. Should only be called for durable clients and with cache server version 5.5 onwards.

Namespace: GemStone.GemFire.Cache
Assembly:  GemStone.GemFire.Cache (in GemStone.GemFire.Cache.dll)
Version: 3.6.4.0

Syntax

C#
public void RegisterKeys(
	CacheableKey[] keys,
	bool isDurable,
	bool getInitialValues
)
Visual Basic (Declaration)
Public Sub RegisterKeys ( _
	keys As CacheableKey(), _
	isDurable As Boolean, _
	getInitialValues As Boolean _
)
Visual C++
public:
void RegisterKeys (
	array<CacheableKey^>^ keys, 
	bool isDurable, 
	bool getInitialValues
)

Parameters

keys
array<CacheableKey>[]()
the array of keys
isDurable
Boolean
whether the registration should be durable
getInitialValues
Boolean
true to populate the cache with values of the keys that were registered on the server

Exceptions

ExceptionCondition
GemStone.GemFire.Cache..::IllegalArgumentException If the array of keys is empty.
GemStone.GemFire.Cache..::IllegalStateException If already registered interest for all keys.
GemStone.GemFire.Cache..::CacheServerException If an exception is received from the Java cache server.
GemStone.GemFire.Cache..::NotConnectedException if not connected to the GemFire system because the client cannot establish usable connections to any of the servers given to it. For pools configured with locators, if no locators are available, innerException of NotConnectedException is set to NoAvailableLocatorsException.
GemStone.GemFire.Cache..::RegionDestroyedException If region destroy is pending.
GemStone.GemFire.Cache..::UnsupportedOperationException If the region is not a Native Client region or SetClientNotificationEnabled(Boolean) is false.
GemStone.GemFire.Cache..::TimeoutException if the operation timed out
GemStone.GemFire.Cache..::UnknownExceptionFor other exceptions.

See Also