PBORCA_SccExcludeLibraryList

Description

Names the libraries in the target library list that should not be synchronized in the next PBORCA_SccRefreshTarget operation.

Syntax

INT PBORCA_SccExcludeLibraryList ( HPBORCA hORCASession, 
   LPTSTR *pLibNames,
   INT iNumberofLibs );

Argument

Description

hORCASession

Handle to previously established ORCA session

*pLibNames

Names of the libraries not to be refreshed

iNumberofLibs

Number of libraries not to be refreshed


Return value

INT.

Usage

This method is useful if PBLs are shared among multiple targets and you are certain that the libraries you list have been successfully refreshed by a previous PBORCA_SccRefreshTarget operation. The refresh target operation will not refresh the libraries that are excluded; however, the excluded libraries will still be used in the full rebuild of the application.

Examples

A previous PBORCA_SccRefreshTarget operation has successfully refreshed three of the four PocketBuilder libraries in this target library list.

LPTSTR      pExcludeArray[3];
INT      lExcludeCount = 3;
TCHAR      szTarget[PBORCA_SCC_PATH_LEN];
LONG            lFlags;
pExcludeArray[0] = new TCHAR[PBORCA_SCC_PATH_LEN];
pExcludeArray[1] = new TCHAR[PBORCA_SCC_PATH_LEN];
pExcludeArray[2] = new TCHAR[PBORCA_SCC_PATH_LEN];
_tcscpy(pExcludeArray[0],
_TEXT("..\\shared_obj\\shared_obj.pkl"));
_tcscpy(pExcludeArray[1],
_TEXT("..\\datatypes\\datatypes.pkl"));
_tcscpy(pExcludeArray[2],
_TEXT("..\\chgreqs\\chgreqs.pkl"));
//  Open ORCA Session, connect to SCC
//  --
_tcscpy(szTarget, _TEXT("dbauto\\dbauto.pkt"));
lFlags = PBORCA_SCC_IMPORTONLY | PBORCA_SCC_OUTOFDATE | 
    PBORCA_SCC_EXCLUDE_CHECKOUT;
lpORCA_Info->lReturnCode = PBORCA_SccSetTarget(
lpORCA_Info->hORCASession, szTarget, lFlags, NULL, NULL);

 

if (lpORCA_Info->lReturnCode == PBORCA_OK)
   {
    lpORCA_Info->lReturnCode = PBORCA_SccExcludeLibraryList(
lpORCA_Info->hORCASession, pExcludeArray, 
lExcludeCount);
     
if (lpORCA_Info->lReturnCode == PBORCA_OK)
{
lpORCA_Info->lReturnCode = PBORCA_SccRefreshTarget(
lpORCA_Info->hORCASession, PBORCA_FULL_REBUILD );
    }
 }
for (int i = 0; i < lExcludeCount; i++)
delete [] pExcludeArrary[i];

See also

PBORCA_SccRefreshTarget

PBORCA_SccSetTarget