IVsLanguageDebugInfo2.QueryCommonLanguageBlock Method

Article
05/06/2010

Determines whether the specified location is contained within a specified type of exception handler block.

Namespace: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop.8.0 (in Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Syntax

'Déclaration
Function QueryCommonLanguageBlock ( _
    pBuffer As IVsTextBuffer, _
    iLine As Integer, _
    iCol As Integer, _
    dwFlag As UInteger, _
    <OutAttribute> ByRef pfInBlock As Integer _
) As Integer
'Utilisation
Dim instance As IVsLanguageDebugInfo2
Dim pBuffer As IVsTextBuffer
Dim iLine As Integer
Dim iCol As Integer
Dim dwFlag As UInteger
Dim pfInBlock As Integer
Dim returnValue As Integer

returnValue = instance.QueryCommonLanguageBlock(pBuffer, _
    iLine, iCol, dwFlag, pfInBlock)

int QueryCommonLanguageBlock(
    IVsTextBuffer pBuffer,
    int iLine,
    int iCol,
    uint dwFlag,
    out int pfInBlock
)

int QueryCommonLanguageBlock(
    [InAttribute] IVsTextBuffer^ pBuffer, 
    [InAttribute] int iLine, 
    [InAttribute] int iCol, 
    [InAttribute] unsigned int dwFlag, 
    [OutAttribute] int% pfInBlock
)

abstract QueryCommonLanguageBlock : 
        pBuffer:IVsTextBuffer * 
        iLine:int * 
        iCol:int * 
        dwFlag:uint32 * 
        pfInBlock:int byref -> int

function QueryCommonLanguageBlock(
    pBuffer : IVsTextBuffer, 
    iLine : int, 
    iCol : int, 
    dwFlag : uint, 
    pfInBlock : int
) : int

Parameters

pBuffer
Type: Microsoft.VisualStudio.TextManager.Interop.IVsTextBuffer
[in] An IVsTextBuffer containing the text to examine.

iLine
Type: System.Int32
[in] Line to examine.

iCol
Type: System.Int32
[in] Column to examine.

dwFlag
Type: System.UInt32
[in] A value from the COMMONLANGUAGEBLOCK enumeration specifying which common block to look for.

pfInBlock
Type: System.Int32%
[out] Returns non-zero if iLine and iCol is inside the specified common language block; otherwise, returns zero.

Return Value

Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From textmgr.idl:

HRESULT IVsLanguageDebugInfo2::QueryCommonLanguageBlock(
   [in] IVsTextBuffer *pBuffer,
   [in] long iLine,
   [in] long iCol,
   [in] DWORD dwFlag,
   [out] BOOL *pfInBlock
);

An exception handler common block is based on the language implemented by the language service but typically includes a try block and a catch block. Some languages support an additional block that is executed regardless of whether an exception occurred; for example, C# has the finally block.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.