Partilhar via


IDiaSession::findLinesByLinenum

Determina os números de linha do compiland que o número da linha especificada em um arquivo de origem se encontra dentro ou próximo.

HRESULT findLinesByLinenum ( 
   IDiaSymbol*           compiland,
   IDiaSourceFile*       file,
   DWORD                 linenum,
   DWORD                 column,
   IDiaEnumLineNumbers** ppResult
);

Parâmetros

  • compiland
    [in] Um IDiaSymbol o objeto que representa o compiland da pesquisa para os números de linha. Este parâmetro não pode ser NULL.

  • file
    [in] Um IDiaSourceFile o objeto que representa o arquivo de origem para pesquisar em. Este parâmetro não pode ser NULL.

  • linenum
    [in] Especifica um número de linha de base um.

    Dica

    Não é possível usar o zero para especificar todas as linhas (use o IDiaSession::findLines método para localizar todas as linhas).

  • column
    [in] Especifica o número da coluna. Use o zero para especificar todas as colunas. Uma coluna é um deslocamento de byte em uma linha.

  • ppResult
    [out] Retorna um IDiaEnumLineNumbers objta que contém uma lista dos números de linha recuperado.

Valor de retorno

Se bem-sucedida, retorna S_OK; Caso contrário, retorna um código de erro.

Exemplo

O exemplo a seguir mostra como abrir um arquivo de origem, enumerar os compilandos contribuiu por este arquivo e localize os números de linha no arquivo de origem onde começa a cada compiland.

void ShowLinesInCompilands(IDiaSession *pSession, LPCOLESTR filename)
{
    IDiaEnumSourceFiles* pEnum;
    IDiaSourceFile*      pFile;
    DWORD                celt;

    pSession->findFile ( NULL, filename, nsFNameExt, &pEnum );
    while ( pEnum->Next ( 1, &pFile, &celt ) == S_OK ) // for each file
    {
        IDiaEnumSymbols* pEnumCompilands;
        IDiaSymbol* pCompiland;

        pFile->get_compilands ( &pEnumCompilands );
        // for each compiland
        while ( pEnumCompilands->Next ( 1, &pCompiland, &celt ) == S_OK )
        {
            IDiaEnumLineNumbers* pEnum;
            // Find first compiland closest to line 1 of the file.
            if (pSession->findLinesByLinenum( pCompiland, pFile, 1, 0, &pEnum ) == S_OK)
            {
                IDiaLineNumber *pLineNumber;
                DWORD lineCount;
                while ( pEnum->Next(1,&pLineNumber,&lineCount) == S_OK)
                {
                     DWORD lineNum;
                     if (pLineNumber->get_line(&lineNum) == S_OK)
                     {
                          printf("compiland starts in source at line number = %lu\n",lineNum);
                     }
                }
            }
        }
    }
}

Consulte também

Referência

IDiaEnumLineNumbers

IDiaSession

IDiaSession::findLinesByAddr

IDiaSourceFile

IDiaSymbol