IDebugControl3::GetExpressionSyntaxNames-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetExpressionSyntaxNames Methode gibt die vollständigen und abgekürzten Namen einer Ausdruckssyntax zurück.

Syntax

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
);

Parameter

[in] Index

Gibt den Index der Ausdruckssyntax an. Index- sollte zwischen Null und der Anzahl der ausdruckssyntaxes sein, die von GetNumberExpressionSyntaxes minus 1 zurückgegeben werden.

[out, optional] FullNameBuffer

Empfängt den vollständigen Namen der Ausdruckssyntax. Wenn FullNameBuffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] FullNameBufferSize

Gibt die Größe des Puffers in Zeichen FullNameBuffer-an. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] FullNameSize

Empfängt die Größe des vollständigen Namens der Ausdruckssyntax in Zeichen. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn "FullNameSize"-NULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] AbbrevNameBuffer

Empfängt den abgekürzten Namen der Ausdruckssyntax. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn AbbrevNameBufferNULL-ist, werden diese Informationen nicht zurückgegeben.

[in] AbbrevNameBufferSize

Gibt die Größe des Puffers in Zeichen AbbrevNameBufferSizean. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] AbbrevNameSize

Empfängt die Größe des abgekürzten Namens der Ausdruckssyntax in Zeichen. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn AbbrevNameSizeNULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Allerdings war entweder FullNameBufferSize oder AbbrevNameBufferSize kleiner als die Größe des jeweiligen Ausdruckssyntaxnamens, und der Name wurde abgeschnitten, um in den Puffer einzupassen.

Bemerkungen

Derzeit gibt es zwei Ausdruckssyntaxen, ihre vollständigen Namen sind "Microsoft Assembler-Ausdrücke" und "C++-Quellausdrücke". Die entsprechenden abgekürzten Ausdruckssyntaxen sind "MASM" und "C++".