Merge pull request #4710 from MicrosoftDocs/master

5/24/2019 AM Publish

Author: Taojunshen

docs/extensibility/breaking-changes-2017.md

@@ -9,7 +9,7 @@ ms.author: "gregvanl"
 manager: jillfra
 ms.workload:
   - "vssdk"
-monikerRange: vs-2017
+
 ---
 # Changes in Visual Studio 2017 extensibility
 

docs/extensibility/debugger/reference/idebugbreakpointboundevent2-enumboundbreakpoints.md

@@ -35,8 +35,7 @@ int EnumBoundBreakpoints( 
 
 ## Parameters
 `ppEnum`\
-
- [out] Returns an [IEnumDebugBoundBreakpoints2](../../../extensibility/debugger/reference/ienumdebugboundbreakpoints2.md) object that enumerates all the breakpoints bound from this event.
+[out] Returns an [IEnumDebugBoundBreakpoints2](../../../extensibility/debugger/reference/ienumdebugboundbreakpoints2.md) object that enumerates all the breakpoints bound from this event.
 
 ## Return Value
 If successful, returns `S_OK`. Returns `S_FALSE` if there are no bound breakpoints; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugbreakpointboundevent2-getpendingbreakpoint.md

@@ -35,8 +35,7 @@ int GetPendingBreakpoint(
 
 ## Parameters
 `ppPendingBP`\
-
- [out] Returns the [IDebugPendingBreakpoint2](../../../extensibility/debugger/reference/idebugpendingbreakpoint2.md) object that represents the pending breakpoint being bound.
+[out] Returns the [IDebugPendingBreakpoint2](../../../extensibility/debugger/reference/idebugpendingbreakpoint2.md) object that represents the pending breakpoint being bound.
 
 ## Return Value
 If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugbreakpointchecksumrequest2-getchecksum.md

@@ -35,12 +35,10 @@ public int GetChecksum(
 
 ## Parameters
 `guidAlgorithm`\
-
- [in] Unique identifier of the checksum algorithm.
+[in] Unique identifier of the checksum algorithm.
 
 `pChecksumData`\
-
- [out] Document checksum for the breakpoint request.
+[out] Document checksum for the breakpoint request.
 
 ## Return Value
 If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugbreakpointchecksumrequest2-ischecksumenabled.md

@@ -32,9 +32,8 @@ public int IsChecksumEnabled(
 ```
 
 ## Parameters
- `pfChecksumEnabled`\
-
- [out] Returns TRUE if the checksum is enabled; otherwise, returns FALSE.
+`pfChecksumEnabled`\
+[out] Returns TRUE if the checksum is enabled; otherwise, returns FALSE.
 
 ## Return Value
  If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugbreakpointerrorevent2-geterrorbreakpoint.md

@@ -35,8 +35,7 @@ int GetErrorBreakpoint( 
 
 ## Parameters
 `ppErrorBP`\
-
- [out] Returns an [IDebugErrorBreakpoint2](../../../extensibility/debugger/reference/idebugerrorbreakpoint2.md) object that describes the warning or error.
+[out] Returns an [IDebugErrorBreakpoint2](../../../extensibility/debugger/reference/idebugerrorbreakpoint2.md) object that describes the warning or error.
 
 ## Return Value
 If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugbreakpointevent2-enumbreakpoints.md

@@ -34,9 +34,8 @@ int EnumBreakpoints(
 ```
 
 ## Parameters
- `ppEnum`\
-
- [out] Returns an [IEnumDebugBoundBreakpoints2](../../../extensibility/debugger/reference/ienumdebugboundbreakpoints2.md) object that enumerates all the breakpoints associated with the current code location.
+`ppEnum`\
+[out] Returns an [IEnumDebugBoundBreakpoints2](../../../extensibility/debugger/reference/ienumdebugboundbreakpoints2.md) object that enumerates all the breakpoints associated with the current code location.
 
 ## Return Value
  If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugbreakpointrequest2-getlocationtype.md

@@ -35,8 +35,7 @@ int GetLocationType(
 
 ## Parameters
 `pBPLocationType`\
-
- [out] Returns a value from the [BP_LOCATION_TYPE](../../../extensibility/debugger/reference/bp-location-type.md) enumeration that describes the location of this breakpoint request.
+[out] Returns a value from the [BP_LOCATION_TYPE](../../../extensibility/debugger/reference/bp-location-type.md) enumeration that describes the location of this breakpoint request.
 
 ## Return Value
 If successful, returns `S_OK`; otherwise, returns an error code. Returns `E_FAIL` if the `bpLocation` field in the associated [BP_REQUEST_INFO](../../../extensibility/debugger/reference/bp-request-info.md) structure is not valid.

docs/extensibility/debugger/reference/idebugbreakpointrequest2-getrequestinfo.md

@@ -36,13 +36,11 @@ int GetRequestInfo( 
 ```
 
 ## Parameters
- `dwFields`\
+`dwFields`\
+[in] A combination of flags from the [BPREQI_FIELDS](../../../extensibility/debugger/reference/bpreqi-fields.md) enumeration that determines which fields in the `pBPRequestInfo` parameter are to be filled out.
 
- [in] A combination of flags from the [BPREQI_FIELDS](../../../extensibility/debugger/reference/bpreqi-fields.md) enumeration that determines which fields in the `pBPRequestInfo` parameter are to be filled out.
-
- `pBPRequestInfo`\
-
- [out] Specifies the [BP_REQUEST_INFO](../../../extensibility/debugger/reference/bp-request-info.md) structure to be filled in with the description of the breakpoint request.
+`pBPRequestInfo`\
+[out] Specifies the [BP_REQUEST_INFO](../../../extensibility/debugger/reference/bp-request-info.md) structure to be filled in with the description of the breakpoint request.
 
 ## Return Value
  If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugbreakpointrequest3-getrequestinfo2.md

@@ -36,13 +36,11 @@ int GetRequestInfo2(
 ```
 
 ## Parameters
- `dwFields`\
+`dwFields`\
+[in] A combination of flags from the [BPREQI_FIELDS](../../../extensibility/debugger/reference/bpreqi-fields.md) enumeration that determine which fields of `pBPRequestInfo` are to be filled in.
 
- [in] A combination of flags from the [BPREQI_FIELDS](../../../extensibility/debugger/reference/bpreqi-fields.md) enumeration that determine which fields of `pBPRequestInfo` are to be filled in.
-
- `bBPRequestInfo`\
-
- [out] The [BP_REQUEST_INFO2](../../../extensibility/debugger/reference/bp-request-info2.md) structure to be filled in.
+`bBPRequestInfo`\
+[out] The [BP_REQUEST_INFO2](../../../extensibility/debugger/reference/bp-request-info2.md) structure to be filled in.
 
 ## Return Value
  If successful, returns `S_OK`; otherwise, returns error code.

docs/extensibility/debugger/reference/idebugbreakpointresolution2-getbreakpointtype.md

@@ -35,8 +35,7 @@ int GetBreakpointType( 
 
 ## Parameters
 `pBPType`\
-
- [out] Returns a value from the [BP_TYPE](../../../extensibility/debugger/reference/bp-type.md) enumeration that specifies the type of this breakpoint.
+[out] Returns a value from the [BP_TYPE](../../../extensibility/debugger/reference/bp-type.md) enumeration that specifies the type of this breakpoint.
 
 ## Return Value
 If successful, returns `S_OK`; otherwise returns an error code. Returns E_FAIL if the `bpResLocation` field in the associated [BP_RESOLUTION_INFO](../../../extensibility/debugger/reference/bp-resolution-info.md) structure is not valid.

docs/extensibility/debugger/reference/idebugbreakpointresolution2-getresolutioninfo.md

@@ -36,13 +36,11 @@ int GetResolutionInfo( 
 ```
 
 ## Parameters
- `dwFields`\
+`dwFields`\
+[in] A combination of flags from the [BPRESI_FIELDS](../../../extensibility/debugger/reference/bpresi-fields.md) enumeration that determine which fields of the `pBPResolutionInfo` parameter are to be filled out.
 
- [in] A combination of flags from the [BPRESI_FIELDS](../../../extensibility/debugger/reference/bpresi-fields.md) enumeration that determine which fields of the `pBPResolutionInfo` parameter are to be filled out.
-
- `pBPResolutionInfo`\
-
- [out] The [BP_RESOLUTION_INFO](../../../extensibility/debugger/reference/bp-resolution-info.md) structure to be filled in with information about this breakpoint.
+`pBPResolutionInfo`\
+[out] The [BP_RESOLUTION_INFO](../../../extensibility/debugger/reference/bp-resolution-info.md) structure to be filled in with information about this breakpoint.
 
 ## Return Value
  If successful, returns `S_OK`; otherwise returns an error code.

docs/extensibility/debugger/reference/idebugbreakpointunboundevent2-getbreakpoint.md

@@ -35,8 +35,7 @@ int GetBreakpoint(
 
 ## Parameters
 `ppBP`\
-
- [out] Returns an [IDebugBoundBreakpoint2](../../../extensibility/debugger/reference/idebugboundbreakpoint2.md) object that represents the breakpoint that became unbound.
+[out] Returns an [IDebugBoundBreakpoint2](../../../extensibility/debugger/reference/idebugboundbreakpoint2.md) object that represents the breakpoint that became unbound.
 
 ## Return Value
 If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugbreakpointunboundevent2-getreason.md

@@ -35,8 +35,7 @@ int GetReason(
 
 ## Parameters
 `pdwUnboundReason`\
-
- [out] Returns a value from the [BP_UNBOUND_REASON](../../../extensibility/debugger/reference/bp-unbound-reason.md) enumeration specifying the reason the breakpoint was unbound.
+[out] Returns a value from the [BP_UNBOUND_REASON](../../../extensibility/debugger/reference/bp-unbound-reason.md) enumeration specifying the reason the breakpoint was unbound.
 
 ## Return Value
 If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugcanstopevent2-canstop.md

@@ -34,9 +34,8 @@ int CanStop ( 
 ```
 
 ## Parameters
- `fCanStop`\
-
- [in] Non-zero (`TRUE`) if the DE should stop at the current code location; otherwise, zero (`FALSE`).
+`fCanStop`\
+[in] Non-zero (`TRUE`) if the DE should stop at the current code location; otherwise, zero (`FALSE`).
 
 ## Return Value
  If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugcanstopevent2-getcodecontext.md

@@ -34,9 +34,8 @@ int GetCodeContext( 
 ```
 
 ## Parameters
- `ppCodeContext`\
-
- [out] Returns the [IDebugCodeContext2](../../../extensibility/debugger/reference/idebugcodecontext2.md) object that represents the current code location.
+`ppCodeContext`\
+[out] Returns the [IDebugCodeContext2](../../../extensibility/debugger/reference/idebugcodecontext2.md) object that represents the current code location.
 
 ## Return Value
  If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugcanstopevent2-getdocumentcontext.md

@@ -34,9 +34,8 @@ int GetDocumentContext ( 
 ```
 
 ## Parameters
- `ppDocCxt`\
-
- [out] Returns the [IDebugDocumentContext2](../../../extensibility/debugger/reference/idebugdocumentcontext2.md) interface that represents a position in a source file document corresponding to the current code location.
+`ppDocCxt`\
+[out] Returns the [IDebugDocumentContext2](../../../extensibility/debugger/reference/idebugdocumentcontext2.md) interface that represents a position in a source file document corresponding to the current code location.
 
 ## Return Value
  If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugcanstopevent2-getreason.md

@@ -34,9 +34,8 @@ int GetReason( 
 ```
 
 ## Parameters
- `pcr`\
-
- [out] Returns a value from the [CANSTOP_REASON](../../../extensibility/debugger/reference/canstop-reason.md) enumeration that describes the reason for this event.
+`pcr`\
+[out] Returns a value from the [CANSTOP_REASON](../../../extensibility/debugger/reference/canstop-reason.md) enumeration that describes the reason for this event.
 
 ## Return Value
  If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugclassfield-doesinterfaceexist.md

@@ -34,9 +34,8 @@ int DoesInterfaceExist(
 ```
 
 ## Parameters
- `pszInterfaceName`\
-
- [in] A string containing the interface name to look for.
+`pszInterfaceName`\
+[in] A string containing the interface name to look for.
 
 ## Return Value
  If successful, returns S_OK, returns S_FALSE if the interface does not exist; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugclassfield-enumbaseclasses.md

@@ -34,9 +34,9 @@ int EnumBaseClasses(
 ```
 
 ## Parameters
- `ppEnum`\
+`ppEnum`\
 
- [out] Returns an [IEnumDebugFields](../../../extensibility/debugger/reference/ienumdebugfields.md) object representing the list of base classes. Returns a null value if there are no base classes.
+[out] Returns an [IEnumDebugFields](../../../extensibility/debugger/reference/ienumdebugfields.md) object representing the list of base classes. Returns a null value if there are no base classes.
 
 ## Return Value
  If successful, returns S_OK, returns S_SH_NO_BASE_CLASSES if there are no base classes (and the `ppEnum` parameter is set to a null value); otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugclassfield-enumconstructors.md

@@ -36,13 +36,11 @@ int EnumConstructors(
 ```
 
 ## Parameters
- `cMatch`\
+`cMatch`\
+[in] A value from the [CONSTRUCTOR_ENUM](../../../extensibility/debugger/reference/constructor-enum.md) enumeration that specifies the type of constructors to enumeration.
 
- [in] A value from the [CONSTRUCTOR_ENUM](../../../extensibility/debugger/reference/constructor-enum.md) enumeration that specifies the type of constructors to enumeration.
-
- `ppEnum`\
-
- [out] Returns an [IEnumDebugFields](../../../extensibility/debugger/reference/ienumdebugfields.md) object representing the list of constructors. Returns a null value if there are no constructors.
+`ppEnum`\
+[out] Returns an [IEnumDebugFields](../../../extensibility/debugger/reference/ienumdebugfields.md) object representing the list of constructors. Returns a null value if there are no constructors.
 
 ## Return Value
  If successful, returns S_OK or returns S_FALSE if there are no constructors. Otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugclassfield-enuminterfacesimplemented.md

@@ -34,9 +34,8 @@ int EnumInterfacesImplemented(
 ```
 
 ## Parameters
- `ppEnum`\
-
- [out] Returns an [IEnumDebugFields](../../../extensibility/debugger/reference/ienumdebugfields.md) object representing the list of interfaces implemented. Returns a null value if there are no interfaces.
+`ppEnum`\
+[out] Returns an [IEnumDebugFields](../../../extensibility/debugger/reference/ienumdebugfields.md) object representing the list of interfaces implemented. Returns a null value if there are no interfaces.
 
 ## Return Value
  If successful, returns S_OK or returns S_FALSE if there are no interfaces implemented on this class. Otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugclassfield-enumnestedclasses.md

@@ -35,8 +35,7 @@ int EnumNestedClasses(
 
 ## Parameters
 `ppEnum`\
-
- [out] Returns an [IEnumDebugFields](../../../extensibility/debugger/reference/ienumdebugfields.md) object representing the list of nested classes. Returns a null value if there are no nested classes.
+[out] Returns an [IEnumDebugFields](../../../extensibility/debugger/reference/ienumdebugfields.md) object representing the list of nested classes. Returns a null value if there are no nested classes.
 
 ## Return Value
 If successful, returns S_OK or returns S_FALSE if there are no nested classes. Otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugclassfield-enumnestedenums.md

@@ -35,8 +35,7 @@ int EnumNestedEnums(
 
 ## Parameters
 `ppEnum`\
-
- [out] Returns an [IEnumDebugFields](../../../extensibility/debugger/reference/ienumdebugfields.md) object representing the list of nested enumerations. Returns a null value if there are no nested enumerations.
+[out] Returns an [IEnumDebugFields](../../../extensibility/debugger/reference/ienumdebugfields.md) object representing the list of nested enumerations. Returns a null value if there are no nested enumerations.
 
 ## Return Value
 If successful, returns S_OK or returns S_FALSE if there are no nested enumerators. Otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugclassfield-getdefaultindexer.md

@@ -34,9 +34,8 @@ int GetDefaultIndexer(
 ```
 
 ## Parameters
- `pbstrIndexer`
-
- [out] Returns a string containing the name of the default indexer.
+`pbstrIndexer`
+[out] Returns a string containing the name of the default indexer.
 
 ## Return Value
  If successful, returns S_OK or returns S_FALSE if there is no default indexer. Otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugclassfield-getenclosingclass.md

@@ -35,8 +35,7 @@ int GetEnclosingClass(
 
 ## Parameters
 `ppClassField`\
-
- [out] Returns an [IDebugClassField](../../../extensibility/debugger/reference/idebugclassfield.md) object representing the enclosing class. Returns a null value if there is no enclosing class.
+[out] Returns an [IDebugClassField](../../../extensibility/debugger/reference/idebugclassfield.md) object representing the enclosing class. Returns a null value if there is no enclosing class.
 
 ## Return Value
 If successful, returns S_OK; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugcodecontext2-getdocumentcontext.md

@@ -34,9 +34,8 @@ int GetDocumentContext( 
 ```
 
 ## Parameters
- `ppSrcCxt`\
-
- [out] Returns the [IDebugDocumentContext2](../../../extensibility/debugger/reference/idebugdocumentcontext2.md) object that corresponds to the code context.
+`ppSrcCxt`\
+[out] Returns the [IDebugDocumentContext2](../../../extensibility/debugger/reference/idebugdocumentcontext2.md) object that corresponds to the code context.
 
 ## Return Value
  If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugcodecontext2-getlanguageinfo.md

@@ -36,13 +36,11 @@ int GetLanguageInfo( 
 ```
 
 ## Parameters
- `pbstrLanguage`\
+`pbstrLanguage`\
+[in, out] Returns a string that contains the name of the language, such as "C++."
 
- [in, out] Returns a string that contains the name of the language, such as "C++."
-
- `pguidLanguage`\
-
- [in, out] Returns the GUID for the language of the code context, for example, `guidCPPLang`.
+`pguidLanguage`\
+[in, out] Returns the GUID for the language of the code context, for example, `guidCPPLang`.
 
 ## Return Value
  If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugcodecontext3-getmodule.md

@@ -33,8 +33,7 @@ public int GetModule(
 
 ## Parameters
 `ppModule`\
-
- [out] Reference to the debug module interface.
+[out] Reference to the debug module interface.
 
 ## Return Value
 If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugcodecontext3-getprocess.md

@@ -33,8 +33,7 @@ public int GetProcess(
 
 ## Parameters
 `ppProcess`\
-
- [out] Reference to the debug process interface.
+[out] Reference to the debug process interface.
 
 ## Return Value
 If successful, returns `S_OK`; otherwise, returns an error code.

docs/extensibility/debugger/reference/idebugcomplussymbolprovider-aresymbolsloaded.md

@@ -36,12 +36,10 @@ int AreSymbolsLoaded (
 
 ## Parameters
 `ulAppDomainID`\
-
- [in] Identifier for the application domain.
+[in] Identifier for the application domain.
 
 `guidModule`\
-
- [in] Unique identifier for the module.
+[in] Unique identifier for the module.
 
 ## Return Value
 If the debug symbols are loaded, returns `S_OK`; otherwise, returns `S_FALSE`.