%HANDLE_FROM_STRING

Create a memory handle from a string

WTSupported in traditional Synergy on Windows

WNSupported in Synergy .NET on Windows

USupported on UNIX

VSupported on OpenVMS

handle = %HANDLE_FROM_STRING(string [, DM_STATIC])

Return value

handle

The memory handle created from the specified string. (D_HANDLE)

Arguments

string

A System.String object to convert to a memory handle. (a)

DM_STATIC

(optional) Classifies the memory handle as static. If this flag is not present, the handle is classified as volatile, or dynamic.

Discussion

%HANDLE_FROM_STRING creates a %MEM_PROC-style memory handle from a String object. This functionality helps to support large XML documents.

See also

• %STRING_FROM_HANDLE routine
• %MEM_PROC routine