MatchToken function (netsh.h)
The MatchToken function determines whether a user-entered string matches a specific string. A match exists if the user-entered string is a case-insensitive prefix of the specific string.
Syntax
BOOL MatchToken(
[in] LPCWSTR pwszUserToken,
[in] LPCWSTR pwszCmdToken
);
Parameters
[in] pwszUserToken
A string entered by the user.
[in] pwszCmdToken
A string against which to check for a match.
Return value
Returns TRUE if there is a match, FALSE if not.
Remarks
The MatchToken function is generally used by command functions. For arguments with an enumerated set of possible values, use the MatchEnumTag function instead.
One example of using MatchToken is a command function that has an argument whose value can be an integer or the string "default". That command function might use MatchToken to test whether the value matches the string "default" before interpreting it as an integer.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | netsh.h |
Library | Netsh.lib |
DLL | Netsh.exe |