%XML_STRING_GETHANDLE

Get the memory handle of an XML string

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
handle = %XML_STRING_GETHANDLE(xml_string)

Return value

handle

The memory handle of the specified string. (D_HANDLE)

Arguments

xml_string

The XML string instance whose handle will be returned. (XML_STRING_TYPE)

Discussion

When processing XML data in a Synergy program, you will probably want to change the XML string into a Synergy memory handle using %XML_STRING_GETHANDLE to get the handle and %XML_STRING_GETSIZE to get its size. You can then use the handle and size in your Synergy program as needed. (For example, you might pass them into the HTTP document transport API.)

This function is defined as ^VAL.

Examples

See XML_to_Synergy_DBMS, available from Synergy CodeExchange in the Synergex Resource Center.