Condividi tramite

IDiaSession::findLinesByLinenum

  • Articolo

Determina i numeri di riga del compiland che il numero di riga specificato in un file di origine si trova all'interno o vicino.

Sintassi

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

Parametri

compiland

[in] Oggetto IDiaSymbol che rappresenta il compiland in cui cercare i numeri di riga. Questo parametro non può essere NULL.

file

[in] Oggetto IDiaSourceFile che rappresenta il file di origine in cui eseguire la ricerca. Questo parametro non può essere NULL.

linenum

[in] Specifica un numero di riga in base uno.

Nota

Non è possibile utilizzare zero per specificare tutte le righe (utilizzare il metodo IDiaSession::findLines per trovare tutte le righe).

column

[in] Specifica il numero di colonna. Usare zero per specificare tutte le colonne. Una colonna è un offset di byte in una riga.

ppResult

[out] Restituisce un oggetto IDiaEnumLineNumbers objta che contiene un elenco dei numeri di riga recuperati.

Valore restituito

Se ha esito positivo, restituisce S_OK; in caso contrario, restituisce un codice di errore.

Esempio

Nell'esempio seguente viene illustrato come aprire un file di origine, enumerare i compilands forniti da questo file e individuare i numeri di riga nel file di origine in cui inizia ogni 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);
                    }
                }
            }
        }
    }
}

Vedi anche