IDebugControl3::GetExpressionSyntaxNames-Methode (dbgeng.h)

Artikel
02/23/2024

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. Der Index sollte zwischen 0 und der Anzahl der von GetNumberExpressionSyntaxes minus 1 zurückgegebenen Ausdruckssyntaxes sein.

[out, optional] FullNameBuffer

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

[in] FullNameBufferSize

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

[out, optional] FullNameSize

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

[out, optional] AbbrevNameBuffer

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

[in] AbbrevNameBufferSize

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

[out, optional] AbbrevNameSize

Empfängt die Größe des abgekürzten Namens der Ausdruckssyntax in Zeichen. Diese Größe enthält den Platz für das "\0"-Endzeichen. 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. Entweder FullNameBufferSize oder AbbrevNameBufferSize war jedoch kleiner als die Größe des jeweiligen Ausdruckssyntaxnamens, und der Name wurde abgeschnitten, um in den Puffer zu passen.

Hinweise

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++".