Metodo IDebugBreakpoint::GetOffsetExpression (dbgeng.h)

Articolo
02/06/2025

I metodi GetOffsetExpression restituiscono la stringa di espressione che restituisce la posizione che attiva un punto di interruzione.

Sintassi

HRESULT GetOffsetExpression(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ExpressionSize
);

Parametri

[out, optional] Buffer

Stringa di espressione che restituisce la posizione nella destinazione che attiva il punto di interruzione. Se buffer è null, queste informazioni non vengono restituite.

[in] BufferSize

Dimensioni, in caratteri, del buffer a cui buffer punta.

[out, optional] ExpressionSize

Dimensione, in caratteri, della stringa dell'espressione. Se ExpressionSize è NULL, queste informazioni non vengono restituite.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo, ma il buffer non era sufficientemente grande da contenere la stringa dell'espressione e quindi la stringa è stata troncata per adattarsi.

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere valori restituiti.

Osservazioni

L'espressione viene valutata ogni volta che un modulo viene caricato o scaricato. Se il debugger non riesce a valutare l'espressione , ad esempio se l'espressione contiene un simbolo che non può essere interpretato, il punto di interruzione viene contrassegnato come posticipato. Per altre informazioni sui punti di interruzione posticipati, vedere Controllo dei flag e dei parametri dei punti di interruzione.

Il metodo getParameters restituisce anche le dimensioni della stringa dell'espressione che specifica il percorso che attiva il punto di interruzione, ExpressionSize.

Per altre informazioni su come usare i punti di interruzione, vedere Uso di punti di interruzione.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Condividi tramite