SccRemove
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

SccRemove Function

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

This function deletes files from the source control system.


SCCRTN SccRemove(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LPCSTR    lpComment,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

Parameters

pvContext

[in] The source control plug-in context structure.

hWnd

[in] A handle to the IDE window that the source control plug-in can use as a parent for any dialog boxes that it provides.

nFiles

[in] Number of files specified in the lpFileNames array.

lpFileNames

[in] Array of fully qualified local path names of files to be removed.

lpComment

[in] The comment to be applied to each file being removed.

fOptions

[in] Command flags (unused).

pvOptions

[in] Source control plug-in-specific options.

The source control plug-in implementation of this function is expected to return one of the following values:

Value Description

SCC_OK

Removal was successful.

SCC_E_FILENOTCONTROLLED

The selected file is not under source control.

SCC_E_OPNOTSUPPORTED

The source control system does not support this operation.

SCC_E_ISCHECKEDOUT

Cannot remove a file because a user currently has it checked out.

SCC_E_ACCESSFAILURE

There was a problem accessing the source control system, probably due to network or contention issues.

SCC_E_NOTAUTHORIZED

The user is not allowed to perform this operation.

SCC_E_NONSPECIFICERROR

Nonspecific failure; file was not removed.

SCC_I_OPERATIONCANCELED

The operation was cancelled before completion.

This function removes the files from the source control system but does not delete them from the user's local hard drive.

Show:
© 2016 Microsoft