Metodo IDebugControl3::GetExpressionSyntaxNames (dbgeng.h)

Articolo
08/07/2023

Il metodo GetExpressionSyntaxNames restituisce i nomi completi e abbreviati di una sintassi di 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. L'indice 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 altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, FullNameBufferSize o AbbrevNameBufferSize è minore delle dimensioni del rispettivo nome della sintassi dell'espressione e il nome è stato troncato per adattarsi all'interno del buffer.

Commenti

Attualmente sono presenti due sintassi delle espressioni, i nomi completi sono "espressioni di Microsoft Assembler" e "espressioni di origine C++". Le sintassi delle espressioni abbreviate corrispondenti sono "MASM" e "C++".