GoFiler Legato Script Reference
Legato v 1.5b Application v 5.24b
|
Table of Contents | < < Previous | Next >> |
Chapter Fifteen — Windows/OS Functions (continued)
Overview
The OLEGetProperty function retrieves a named variable or property from a specified OLE Object.
Syntax/Parameters
Syntax
var = OLEGetProperty ( handle hOLE, string name, ... );
Parameters
hOLE
A handle to an open OLE Object connection.
name
A string specifying a defined OLE name. See Remarks.
(args)
A list of various parameters of varying types depending on the method and OLE Object. The total amount allowed is limited to 14.
Return Value
Returns an var as a type as specified by the OLE processor. Use the GetLastError, IsError or IsNotError function to determine if the function succeeded.
Assuming the OLE method was run, the last error value will contain the VT_ code (see table at the start of the section). Retrieving this code can be useful to determine the type of data being returned by the server.
Remarks
OLEGetProperties provides a generic process to retrieve specific information from an OLE object. The name parameter must be known to the connected object. Note that the OLERunMethod and OLEPutProperty functions are very similar in that a specific method of verb is communicated to the OLE server.
The return value is dependent on the method parameter and the connected OLE Object. The type may be: handle, string, wstring, any integer based type, or float. It is up to the developer to insure that the return type is correct such that the script will not encounter a runtime type mismatch error. For strings, the OLE default type is VT_BSTR which is returned as a wstring type.
Related Functions
Platform Support
Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL
Legato IDE
Table of Contents | < < Previous | Next >> |
© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.