Execute DLL Function Action

Description

Executes the specified method in a managed or unmanaged dynamic-link library (DLL) and stores the return value of the method in an Automated Workflow variable.

Declaration

<AMEXECUTEDLLFUNCTION DLLFILEPATH="text" METHODENAME="text" RETURNTYPE="text" RESULTVARIABLE="text [variable name]" />

Example

<AMEXECUTEDLLFUNCTION DLLFILEPATH="%AMTrigger.WorkflowLate%" METHODENAME="%AMTrigger.Value%" RETURNTYPE="Single" RESULTVARIABLE="newvariable" />

General Tab Parameters

Dynamic-link library: Allows you to navigate to a specific DLL.

Text, Required
MARKUP: DLLFILEPATH="newlib.dll"

Method Name: Allows you to specify a method name to execute.

Text, Required
MARKUP:METHODENAME="name"

Method return value type: Specifies the type of the return value for the method. The available options are:

  • Boolean

  • Byte

  • Char

  • Decimal

  • Double

  • Int16

  • Int32

  • Int64

  • SByte

  • Single

  • String

  • UInt16

  • UInt32

  • UTint64

  • Void

Text, Optional  
MARKUP: RETURNTYPE="void"

Variable to populate with return value: Allows you to enter a variable name for the return value.

Text [options], Optional - Default "Execute"
MARKUP: RESULTVARIABLE="new variable name"

Unload DLL after execution: Selected by default.

Arguments Tab Parameters

  1. In the left drop-down list (Boolean), click the down arrow and select the type of argument.

  2. In the right box, type a value for the argument, then click Add. The Type and Value appear in the list.  

Type: Allows you to select the type of argument you want to assign a value to. The available options are:

  • Boolean

  • Byte

  • Char

  • Decimal

  • Double

  • Int16

  • Int32

  • Int64

  • SByte

  • Single

  • String

  • UInt16

  • UInt32

  • UTint64

  • Void

Value: Allows you to assign a value to the argument.

Add: Allows you to add and new argument type and value.

Move up: Allows you to move the argument up the argument list.

Move down: Allows you to move the argument down the argument list.

Modify: Allows you to edit an existing argument.

Remove: Allows you to delete an existing argument.

See Also

DDE Action