SccProperties Function

This function displays source control properties for a file or project.

Syntax

SCCRTN SccProperties (
   LPVOID pvContext,
   HWND   hWnd,
   LPCSTR lpFileName
);

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.

lpFileName

[in] The fully qualified path name of the file or project.

Return Value

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

Value Description
SCC_OK Properties were successfully displayed.
SCC_I_RELOADFILE The version control system has modified the file properties, so the IDE should reload this file.
SCC_E_PROJNOTOPEN The specified project has not been opened in source control.
SCC_E_NOTAUTHORIZED The user is not authorized to view properties of this file or project.
SCC_E_FILENOTCONTROLLED The specified file or project is not under source control.
SCC_E_NONSPECIFICERROR

SCC_E_UNKNOWNERROR
An unknown or general error occurred.

Remarks

The source control plug-in displays the properties in its own dialog box.

The properties are defined by the source control plug-in and may differ from plug-in to plug-in. If the plug-in allows the user to change the source control properties of a file, it should return SCC_I_RELOAD to signal the IDE that this file or project needs to be reloaded.

See also