PBORCA_DeployWinFormProject

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.