SetUnnamedArgStr

The SetUnnamedArgStr method sets an unnamed string argument for the current extension command.

bool
  ExtExtension::SetUnnamedArgStr(
    IN ULONG  Index,
    IN PCSTR  Arg,
    IN bool  OnlyIfUnset = false
    ) throw(...)

Parameters

Index

Specifies the index of the argument. The command-line description used in EXT_COMMAND must specify that the type of this argument is string. Index should be between zero and the number of unnamed arguments – as specified in the command-line description used in EXT_COMMAND – minus one.

Arg

A string that specifies the value of the unnamed argument. A pointer to the first non-space character is saved as the argument.

OnlyIfUnset

Specifies what happens if the argument is already set. If OnlyIfUnset is true and the argument has already been set, the argument will not be changed. If OnlyIfUnset is false and the argument has already been set, the argument will be changed.

Return Value

SetUnnamedArgStr returns true if the argument was changed; false otherwise.

Comments

For an overview of argument parsing in the EngExtCpp extensions framework, see Parsing Extension Arguments.

This method should only be called during the execution of an extension command provided by this class.

Requirements

Headers: Defined in Engextcpp.hpp. Include Engextcpp.hpp.

See Also

EXT_COMMAND