User Guide

126 Chapter 10: The Source Control Integration API
bool SCS_GetNewFeatures()
Description
This function returns a list of menu items to add to the Dreamweaver main and context menus.
For example, the Sourcesafe DLL can add History and File Differences to the main menu.
Arguments
char menuItemList[][32]
, scFunction functionList[], scFunction enablerList[],
const int numNewFeatures
• The menuItemList argument is a string list that is populated by the DLL; it specifies the
menu items to add to the main and context menus. Each string can contain a maximum of
32 characters.
• The functionList argument is populated by the DLL; it specifies the routines in the DLL to
call when the user selects the corresponding menu item.
• The enablerList argument is populated by the DLL; it specifies the routines in the DLL to
call when Dreamweaver needs to determine whether the corresponding menu item is enabled.
• The numNewFeatures argument is the number of items being added by the DLL; this value is
retrieved from the
GetNumNewFeatures() call.
The following function signature defines the functions and enablers that passed to the
SCS_GetNewFeatures() call in the functionlist and enablerList arguments.
bool (*scFunction)(void *connectionData, const char *remotePathList[],
const char *localPathList[], const int numItems)
Returns
A Boolean value: true if successful; false otherwise.
bool SCS_GetCheckoutName()
Description
This function returns the check-out name of the current user. If it is unsupported by the source
control system and this feature is enabled by the user, this function uses the Dreamweaver
internal Check In/Check Out functionality, which transports LCK files to and from the source
control system.
Arguments
void *connectionData
, char checkOutName[64], char emailAddress[64]
• The connectionData argument is a pointer to the agent’s data that passed into Dreamweaver
during the
Connect() call.
• The checkOutName argument is the name of the current user.
• The emailAddress argument is the e-mail address of the current user.
Returns
A Boolean value: true if successful; false otherwise.
000_DW_API_Print.book Page 126 Wednesday, August 20, 2003 9:14 AM