PBORCA_LibraryCreate
Description
Creates a new PowerBuilder library.
Syntax
|
1 2 3 |
INT PBORCA_LibraryCreate ( HPBORCA hORCASession, LPTSTR lpszLibraryName, LPTSTR lpszLibraryComments ); |
|
Argument |
Description |
|---|---|
|
hORCASession |
Handle to previously established ORCA |
|
lpszLibraryName |
Pointer to a string whose value is the file name of |
|
lpszLibraryComments |
Pointer to a string whose value is a comment |
Return value
INT. Typical return codes are:
|
Return code |
Description |
|---|---|
|
0 PBORCA_OK |
Operation successful |
|
-1 PBORCA_INVALIDPARMS |
Invalid parameter list |
|
-4 PBORCA_BADLIBRARY |
Bad library name |
|
-7 PBORCA_LIBIOERROR |
Library I/O error |
|
-8 PBORCA_OBJEXISTS |
Object already exists |
|
-9 PBORCA_INVALIDNAME |
Library name is not valid |
Usage
You do not need to set the library list or current application
before calling this function.
Adding objects
PBORCA_LibraryCreate creates an empty library file on disk. You can
add objects to the library from other libraries with functions like
PBORCA_LibraryEntryCopy and PBORCA_CheckOutEntry. If you set the library
list so that it includes the new library and then set the current
application, you can import object source code with
PBORCA_CompileEntryImport and PBORCA_CompileEntryImportList.
Examples
This example creates a library called NEWLIB.PBL and provides a
descriptive comment:
|
1 2 3 4 5 6 7 8 9 10 11 |
LPTSTR pszLibraryName; LPTSTR pszLibraryComments; // Specify library name and comment string pszLibraryName = _TEXT("c:\appeon\pb2017\demo\newlib.pbl"); pszLibraryComments = _TEXT("PBL contains ancestor objects for XYZ app."); // Create the library lpORCA_Info->lReturnCode = PBORCA_LibraryCreate(lpORCA_Info->hORCASession, pszLibraryName, pszLibraryComments); |
In these examples, session information is saved in the data
structure ORCA_Info, shown in About the examples.
See also