ExtExtension::SetUnnamedArg-Methode (engextcpp.hpp)

Die SetUnnamedArg- -Methode legt ein nicht benanntes Argument für den aktuellen Erweiterungsbefehl fest.

Syntax

bool SetUnnamedArg(
  [in]           ULONG   Index,
  [in, optional] PCSTR   StrArg,
  [in]           ULONG64 NumArg,
  [in]           bool    OnlyIfUnset
);

Parameter

[in] Index

Gibt den Index des Arguments an. Index- sollte zwischen Null und der Anzahl der nicht benannten Argumente stehen, wie in der Befehlszeilenbeschreibung angegeben, die in EXT_COMMANDverwendet wird, minus 1 (nicht benannte Argumente - 1).

[in, optional] StrArg

Eine Zeichenfolge, die den Wert des nicht benannten Arguments angibt.

Wenn das Argument vom Typ Zeichenfolgeist, wird ein Zeiger auf das erste Nicht-Leerzeichen als Argument gespeichert. In diesem Fall darf StrArg- nicht NULL-sein.

Wenn das Argument vom Typ Ausdruckist, wird StrArg mithilfe des Standardausdruck-Evaluators ausgewertet, und der vom Standardausdruck-Evaluator zurückgegebene Wert wird zum Wert des Arguments. In diesem Fall kann StrArg-NULL- sein, und stattdessen sollte NumArg- verwendet werden.

Wenn das Argument vom Typ booleschenist, wird StrArg ignoriert und kann NULL-werden.

[in] NumArg

Gibt den Wert eines nicht benannten Ausdrucksarguments an. NumArg- wird nur verwendet, wenn das Argument vom Typ Ausdruck ist und StrArg-NULL-ist.

[in] OnlyIfUnset

Gibt an, was passiert, wenn das Argument bereits festgelegt ist. Wenn OnlyIfUnset-true ist und das Argument bereits festgelegt wurde, wird das Argument nicht geändert. Wenn OnlyIfUnset-false ist und das Argument bereits festgelegt wurde, wird das Argument geändert.

Rückgabewert

SetUnnamedArg- gibt true zurück, wenn das Argument geändert wurde; andernfalls false.

Bemerkungen

Eine Übersicht über die Argumentanalyse im EngExtCpp-Erweiterungsframework finden Sie unter Parsing Extension Arguments.

Diese Methode sollte nur während der Ausführung eines Erweiterungsbefehls aufgerufen werden, der von dieser Klasse bereitgestellt wird.

Anforderungen

Siehe auch

EXT_COMMAND

ExtExtension-