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