Metodo IDebugBreakpoint::GetOffsetExpression (dbgeng.h)

  • Articolo

I metodi GetOffsetExpression restituiscono la stringa di espressione che restituisce la posizione in cui viene attivato 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

Dimensione, in caratteri, del buffer a cui punta Buffer .

[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 è stato eseguito correttamente.
S_FALSE
 Il metodo ha avuto esito positivo, ma il buffer non è sufficientemente grande da contenere la stringa di espressione e quindi la stringa è stata troncata per adattarsi.
 

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

Commenti

L'espressione viene valutata ogni volta che un modulo viene caricato o scaricato. Se il debugger non è in grado di 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 di espressione che specifica la posizione che attiva il punto di interruzione ExpressionSize.

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

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione dbgeng.h (include Dbgeng.h)