MACROMEDIA DREAMWEAVER 8-DREAMWEAVER API, Reference

Page: 132 / 628

132 The Source Control Integration API
bool SCS_GetFileCheckoutList()
Description
This function returns a list of users who have a file checked out. If the list is empty, no one has
the file checked out.
Arguments
void *connectionData , const char * remotePath , char checkOutList[][64] , char
emailAddressList[][64] , const int numCheckedOut
■
The
connectionData
argument is a pointer to the agent’s data that passed into
Dreamweaver during the
Connect()
call.
■
The
remotePath
argument is the remote file or folder path to check how many users have
it checked out.
■
The
checkOutList
argument is a list of strings that corresponds to the users who have
the file checked out. Each user string cannot exceed a maximum length of 64 characters.
■
The
emailAddressList
argument is a list of strings that corresponds to the users’ e-mail
addresses. Each e-mail address string cannot exceed a maximum length of 64 characters.
■
The
numCheckedOut
argument is the number of people who have the file checked out.
This is returned from
GetNumCheckedOut()
.
Returns
A Boolean value:
true
if successful;
false
otherwise.
int SCS_GetErrorMessageLength()
Description
This function returns the length of the DLL’s current internal error message. This allocates the
buffer that passes into the
GetErrorMessage()
function. This function should be called only
if an API function returns
false
or
<0
, which indicates a failure of that API function.
Arguments
void *connectionData
■
The
connectionData
argument is a pointer to the agent’s data that passed into
Dreamweaver during the
Connect()
call.
Returns
An integer that represents the length of the error message.
000_DW_API_Print.book Page 132 Wednesday, July 20, 2005 11:58 AM