SccGetUserOption Function

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

This function retrieves a variety of user-specific options.

Syntax

SCCRTN SccGetUserOption(
   LPVOID pContext,
   LONG nOption,
   LPLONG lpVal
);

Parameters

pContext

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

nOption

[in] Option to retrieve (see Remarks for possible options).

lpVal

[out] Value associated with option.

Return Value

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

Value Description
SCC_OK Option was retrieved successfully.
SCC_E_OPNOTSUPPORTED Option is not supported.
SCC_E_NONSPECIFICERROR An unspecified error occurred.

Remarks

The following options are supported by this command:

User Option Description
SCC_USEROPT_CHECKOUT_LOCALVER Determines whether the user wants to check out local version of files. lpVal is assigned SCC_USEROPT_COLV_YES (user wants to check out local files) or SCC_USEROPT_COLV_NO.

See also