Metodo IDebugControl3::GetExpressionSyntaxNames (dbgeng.h)

Articolo
02/06/2025

Il metodo GetExpressionSyntaxNames restituisce i nomi completi e abbreviati di una sintassi di un'espressione.

Sintassi

HRESULT GetExpressionSyntaxNames(
  [in]            ULONG  Index,
  [out, optional] PSTR   FullNameBuffer,
  [in]            ULONG  FullNameBufferSize,
  [out, optional] PULONG FullNameSize,
  [out, optional] PSTR   AbbrevNameBuffer,
  [in]            ULONG  AbbrevNameBufferSize,
  [out, optional] PULONG AbbrevNameSize
);

Parametri

[in] Index

Specifica l'indice della sintassi dell'espressione. index deve essere compreso tra zero e il numero di sintassi delle espressioni restituite da GetNumberExpressionSyntaxes meno uno.

[out, optional] FullNameBuffer

Riceve il nome completo della sintassi dell'espressione. Se FullNameBuffer è null, queste informazioni non vengono restituite.

[in] FullNameBufferSize

Specifica le dimensioni, in caratteri, del buffer FullNameBuffer. Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] FullNameSize

Riceve le dimensioni, in caratteri, del nome completo della sintassi dell'espressione. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se FullNameSize è null, queste informazioni non vengono restituite.

[out, optional] AbbrevNameBuffer

Riceve il nome abbreviato della sintassi dell'espressione. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se AbbrevNameBuffer è NULL, queste informazioni non vengono restituite.

[in] AbbrevNameBufferSize

Specifica le dimensioni, in caratteri, del buffer AbbrevNameBufferSize. Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] AbbrevNameSize

Riceve le dimensioni, in caratteri, del nome abbreviato della sintassi dell'espressione. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se abbrevNameSize è null, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo. Tuttavia, FullNameBufferSize o AbbrevNameBufferSize era inferiore alle dimensioni del nome della sintassi dell'espressione corrispondente e il nome è stato troncato per adattarsi all'interno del buffer.

Osservazioni

Attualmente sono disponibili due sintassi di espressione, i relativi nomi completi sono "Espressioni Assembler Microsoft" ed "Espressioni di origine C++". Le sintassi delle espressioni abbreviate corrispondenti sono "MASM" e "C++".