This method is used to inform the server that the client has finished processing a given result set allowing the server to free resources managing this result set. The server should keep the data of the result set available for the client until the ReleaseResultHandle method is called or until a timeout given by the client has expired.
However, the server is free to release the data at any time, depending on its internal resource management, so the client cannot rely on the data being available. ReleaseResultHandle is merely a hint allowing the server to optimize its internal resource management. For timeout usage see the description.
Note: The ResultHandle is provided as an option to be used by application for flexibility. Applications can choose to use it based on the use case or ignore it.
Signature
ReleaseResultHandle (
[in]UInt32ResultHandle,
[out]Int32Error)
Table 54 - ReleaseResultHandle Method Arguments
Argument |
Description |
ResultHandle |
Handle returned by GetResultById or GetResultListFiltered or GetLatestResult, identifying the result set/client combination. |
Error |
0 – OK Values > 0 are reserved for errors defined by this and future standards. Values < 0 shall be used for application-specific errors. |
Table 55 - ReleaseResultHandle Method AddressSpace definition
Attribute |
Value |
||||
BrowseName |
ReleaseResultHandle |
||||
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
Others |
HasProperty |
Variable |
InputArguments |
Argument[] |
PropertyType |
M |
HasProperty |
Variable |
OutputArguments |
Argument[] |
PropertyType |
M |