PBORCA_LibraryEntryMove

Description

Moves a PowerBuilder library entry from one library to another.

Syntax

INT PBORCA_LibraryEntryMove ( PBORCA hORCASession, 
   LPTSTR lpszSourceLibName, 
   LPTSTR lpszDestLibName, 
   LPTSTR lpszEntryName, 
   PBORCA_TYPE otEntryType );

Argument

Description

hORCASession

Handle to previously established ORCA session.

lpszSourceLibName

Pointer to a string whose value is the file name of the source library containing the object.

lpszDestLibName

Pointer to a string whose value is the file name of the destination library to which you want to move the object.

lpszEntryName

Pointer to a string whose value is the name of the object being moved.

otEntryType

A value of the PBORCA_TYPE enumerated data type specifying the object type of the entry being moved. Values are:

PBORCA_APPLICATION

PBORCA_DATAWINDOW

PBORCA_FUNCTION

PBORCA_MENU

PBORCA_QUERY

PBORCA_STRUCTURE

PBORCA_USEROBJECT

PBORCA_WINDOW

PBORCA_PIPELINE

PBORCA_PROJECT

PBORCA_PROXYOBJECT


Return value

INT. Typical return codes are:

Return code

Description

0       PBORCA_OK

Operation successful

-1      PBORCA_INVALIDPARMS

Invalid parameter list

-3      PBORCA_OBJNOTFOUND

Object not found

-4      PBORCA_BADLIBRARY

Bad library name

-7      PBORCA_LIBIOERROR

Library I/O error


Usage

You do not need to set the library list or current application before calling this function.

Like PBORCA_LibraryEntryCopy, one call to PBORCA_LibraryEntryMove automatically moves the source component and then moves the binary component of an object if it is present.

Examples

This example moves a DataWindow named d_labels from the library SOURCE.PBL to DESTIN.PBL:

lpORCA_Info->lReturnCode = PBORCA_LibraryEntryMove(
   lpORCA_Info->hORCASession,
    _TEXT("c:\\app\\source.pbl"),
     _TEXT ("c:\\app\\destin.pbl"),
     _TEXT ("d_labels"), PBORCA_DATAWINDOW);

This example assumes that the pointers for lpszSourceLibraryName, lpszDestinationLibraryName, and lpszEntryName point to valid library and object names and that otEntryType is a valid object type:

lpORCA_Info->lReturnCode = PBORCA_LibraryEntryMove(
   lpORCA_Info->hORCASession,
   lpszSourceLibraryName, lpszDestinationLibraryName,
   lpszEntryName, otEntryType );

See also

PBORCA_LibraryEntryCopy

PBORCA_LibraryEntryDelete