IStreamContainer.GetMap Method

Solclient

IStreamContainerGetMap Method
version: 7.2.1.27
Opens the contained sub-map with the given name. The returned IMapContainer is ready for read and write operations. It is recommended to Close the IMapContainer when done. If it is not explicitly closed, the container is automatically closed when the associated parent container is closed or the associated message (if it is a message-dependent container) is disposed.

Whether it is explicitly closed by the client application, or implicitly by the API, any attempt to use this container will result in an OperationErrorException with ParamNullReference error subcode.

Namespace: SolaceSystems.Solclient.Messaging.SDT
Assembly: SolaceSystems.Solclient.Messaging (in SolaceSystems.Solclient.Messaging.dll) Version: 7.2.1.27 (7.2.1.27)
Syntax
IMapContainer GetMap()
Function GetMap As IMapContainer
IMapContainer^ GetMap()

Return Value

Type: IMapContainer
An opened sub-map.
Exceptions
ExceptionCondition
EndOfStreamException When end of stream is reached.
OperationErrorException Thrown when an error occurs. In this case ReturnCode and SDKErrorInfo are accessible from OperationErrorException and contain more information.
FatalErrorException Thrown when an unrecoverable error occurs.
InvalidOperationException Thrown when the container is already closed.
See Also