通过

PreprocessCommand 函数 (netsh.h)

  • 项目

PreprocessCommand 函数分析参数字符串并验证是否存在所有必需的标记。

语法

DWORD PreprocessCommand(
            HANDLE   hModule,
  [in, out] LPWSTR   *ppwcArguments,
  [in]      DWORD    dwCurrentIndex,
  [in]      DWORD    dwArgCount,
  [in]      TAG_TYPE *pttTags,
  [in]      DWORD    dwTagCount,
  [in]      DWORD    dwMinArgs,
  [in]      DWORD    dwMaxArgs,
  [out]     DWORD    *pdwTagType
);

参数

hModule

保留。 设置为 null。

[in, out] ppwcArguments

传递给 FN_HANDLE_CMD 的参数 (命令函数) 作为其 ppwcArguments 参数。

[in] dwCurrentIndex

一个 值，该值指定要处理的第一个参数，因此 ppwcArguments[dwCurrentIndex] 是第一个参数。

[in] dwArgCount

作为 dwArgCount 参数传递的参数计数。

[in] pttTags

TAG_TYPE 类型的标记数组。

[in] dwTagCount

pttTags 数组中的多个条目。

[in] dwMinArgs

此命令所需的最小参数数。

[in] dwMaxArgs

此命令允许的最大参数数。

[out] pdwTagType

一个 DWORD数组，至少有足够的空间容纳等于 dwArgCount - dwCurrentIndex 的条目数。 每个 DWORD 都包含 pttTags 数组中的数组索引号， ppwcArguments 数组中的数组索引号与之匹配。 例如，如果 ppwcArguments[0] 匹配到 pttTags[2]， 则 pdwTagType[0] 为 2。

返回值

返回代码 说明
NO_ERROR
 函数已成功完成。
ERROR_INVALID_SYNTAX
 语法无效。
ERROR_TAG_ALREADY_PRESENT
 标记已存在。
ERROR_INVALID_PARAMETER
 输入的参数无效。
ERROR_INVALID_OPTION_TAG
 选项标记无效。
ERROR_NOT_ENOUGH_MEMORY
 没有足够的内存可用于执行命令。
 
 

注解

PreprocessCommand 函数通常由命令函数调用。 此函数分析所有参数，将参数与标记匹配，并将 pdwTagType 数组中每个参数的类型 (标记索引保留) ，其中 pdwTagType[0] 对应于 ppwcArguments[dwCurrentIndex] 的类型。 PreprocessCommand 函数还确保存在所需的标记。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 netsh.h
Library Netsh.lib
DLL Netsh.exe

另请参阅

FN_HANDLE_CMD

TAG_TYPE