CIP Visual Basic.NET documentation for interface "IpfcDll"

Interface IpfcDll

Description

This interface represents a Creo Parametric TOOLKIT DLL.

See Also:: IpfcBaseSession.GetProToolkitDll(), IpfcBaseSession.LoadProToolkitDll()

Direct Parent Classes:: IpfcChild

Property Summary


`Property`	`Id`	`as String`
	The DLL identifier string. Use `IpfcBaseSession.GetProToolkitDll()` to obtain a DLL handle using this string.

Method Summary


`Function`	`CallFunction (FunctionName as String, InputArguments as IpfcArguments, UsedToolkit as IpfcToolkitType) as IpfcFunctionReturn`


`Function`	`ExecuteFunction (FunctionName as String, InputArguments as IpfcArguments) as IpfcFunctionReturn`
	Causes Creo Parametric to call a function in a Creo Parametric TOOLKIT DLL application.

`Function`	`IsActive () as Boolean`
	Helper method for determining if application that this `IpfcDll` object has been unloaded.

`Sub`	`Unload ()`
	Unloads a previously loaded DLL application.

Property Detail

Property Id as String

The DLL identifier string. Use IpfcBaseSession.GetProToolkitDll() to obtain a DLL handle using this string.

Exceptions thrown (but not limited to):

IpfcXToolkitBadContext - application handle is valid but application was not running.

Method Detail

Function CallFunction (FunctionName as String, InputArguments as IpfcArguments, UsedToolkit as IpfcToolkitType) as IpfcFunctionReturn

Exceptions thrown (but not limited to):

IpfcXToolkitBadContext - application handle is valid but the app was not running.

IpfcXToolkitUserAbort - The DLL function returned something besides

IpfcXToolkitNotFound - The function named could not be found and called.

IpfcXToolkitInvalidPtr - One or more of the function argument arrays contain value data of type pfcARG_V_POINTER. These structures cannot be transferred.

Parameters:

FunctionName
InputArguments
UsedToolkit

Returns:

Function ExecuteFunction (FunctionName as String, InputArguments as IpfcArguments) as IpfcFunctionReturn

Causes Creo Parametric to call a function in a Creo Parametric TOOLKIT DLL application.

The function must have a signature matching ProTkdllFunction in ProToolkitDll.h. The function must be exported using the proper macros, functions, and linker options that allow Creo Parametric to call the function. See the Creo Parametric TOOLKIT User's Guide and ProToolkitDll.h for more details.

Exceptions thrown (but not limited to):

IpfcXToolkitBadContext - application handle is valid but the app was not running.

IpfcXToolkitUserAbort - The DLL function returned something besides correct value. Check pfcFunctionReturn values for more details.

IpfcXToolkitNotFound - The function named could not be found and called.

IpfcXToolkitInvalidPtr - One or more of the function argument arrays contain value data of type pfcARG_V_POINTER.

IpfcXToolkitDllInactive - Application handle is not active

See Also:: IpfcBaseSession.LoadProToolkitDll(), IpfcArgument.Create()

Parameters:

FunctionName: The function name.
InputArguments: Sequence of input argument name-value pairs to be passed to the function.

Returns:: The function return value, as integer, and the output arguments passed back from the function call.

Function IsActive () as Boolean

Helper method for determining if application that this IpfcDll object has been unloaded.

Returns:: Whether or not the application has been unloaded.

Sub Unload ()

Unloads a previously loaded DLL application.

You are only permitted to unload applications that you previously loaded with IpfcBaseSession.LoadProToolkitDll().