Description
Generates and compiles Windows Forms project and deploys the assemblies according to the specifications contained in the project objects.
Syntax
INT PBORCA_DeployWinFormProject ( HPBORCA hORCASession, LPTSTR lpszLibraryName, LPTSTR lpszProjectName, LPTSTR lpszIconFileName, PBORCA_DOTNETPROC pDotNetProc LPVOID pUserData );
Argument |
Description |
---|---|
hORCASession |
Handle to previously established ORCA session. |
lpszLibraryName |
Pointer to a string whose value is the file name containing the project entry. |
lpszProjectName |
Project object containing deployment information. |
lpszIconFileName |
Name of the application icon file. |
pDotNetProc |
Pointer to the PBORCA_DOTNETPROC callback function. The callback function is called for each message that is generated. All ORCA_ERROR_MESSAGE messages are returned first, followed by all PBORCA_WARNING_MESSAGE messages, and then, by all PBORCA_UNSUPPORTED_FEATURE messages. |
pUserData |
Pointer to user data to be passed to the PBORCA_DOTNETPROC callback function. |
Return value
INT. The typical return codes are:
Return code |
Description |
---|---|
0 PBORCA_OK |
Operation successful |
-1 PBORCA_INVALIDPARMS |
Invalid parameter list |
-4 PBORCA_BADLIBRARY |
Load library for necessary DLL failed |
-5 PBORCA_LIBLISTNOTSET |
SessionSetLibraryList is prerequisite |
-13 PBORCA_CURRAPPLNOTSET |
SessionSetCurrentAppl is prerequisite |
-19 PBORCA_CBCREATEERROR |
Component builder create error |
-20 PBORCA_CBINITERROR |
Component builder initialization error |
-21 PBORCA_CBBUILDERROR |
Component builder build error |
Usage
Error information is returned by first creating a callback function associated with PBORCA_DeployWinFormProject that uses the following function signature:
void MyDotNetMessageProc ( PPBORCA_DOTNET_MESSAGE pMsg, LPVOID pMyUserData)
The pMsg argument is a pointer to the following structure:
typedef struct pborca_dotnetmsg { PBROCA_DOTNET_MSGTYPE eMessageType; LPTSTR lpszMessageText; } PBORCA_DOTNET_MESSAGE FAR *PPBORCA_DOTNET_MESSAGE;
The eMessageType argument uses the following enumeration:
typedef enum pborca_dotnet_msgtype { PBORCA_ERROR_MESSAGE, PBORCA_WARNING_MESSAGE, PBORCA_UNSUPPORTED_FEATURE } PBORCA_DOTNET_MSGTYPE;
Messages are returned to the caller one at a time in the following order: PBORCA_ERROR_MESSAGE messages, PBORCA_WARNING_MESSAGE messages, and PBORCA_UNSUPPORTED_FEATURE messages.