Función PreprocessCommand (netsh.h)

La función PreprocessCommand analiza una cadena de argumento y comprueba que todas las etiquetas necesarias están presentes.

Sintaxis

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
);

Parámetros

hModule

Reservado. Establecer en null.

[in, out] ppwcArguments

Los argumentos pasados a FN_HANDLE_CMD (la función de comando) como su parámetro ppwcArguments .

[in] dwCurrentIndex

Valor que especifica el primer argumento que se va a procesar, de modo que ppwcArguments[dwCurrentIndex] es el primero.

[in] dwArgCount

Recuento de argumentos pasado como parámetro dwArgCount .

[in] pttTags

Matriz de etiquetas de tipo TAG_TYPE.

[in] dwTagCount

Número de entradas de la matriz pttTags .

[in] dwMinArgs

Número mínimo de argumentos necesarios para este comando.

[in] dwMaxArgs

Número máximo de argumentos permitidos para este comando.

[out] pdwTagType

Matriz de DWORDs, con al menos suficiente espacio para una serie de entradas iguales a dwArgCount - dwCurrentIndex. Cada DWORD contiene el número de índice de matriz de la matriz pttTags a la que coincide el número de índice de matriz de la matriz ppwcArguments . Por ejemplo, si ppwcArguments[0] coincide con pttTags[2], pdwTagType[0] es 2.

Valor devuelto

Código devuelto	Descripción
NO_ERROR	Si se devuelve este valor, significa que la función se completó correctamente.
ERROR_INVALID_SYNTAX	Sintaxis no válida.
ERROR_TAG_ALREADY_PRESENT	La etiqueta ya está presente.
ERROR_INVALID_PARAMETER	Se especificó un parámetro no válido.
ERROR_INVALID_OPTION_TAG	Etiqueta de opción no válida.
ERROR_NOT_ENOUGH_MEMORY	No hay suficiente memoria disponible para llevar a cabo el comando.

 

 

Comentarios

Normalmente, las funciones de comando llaman a la función PreprocessCommand . Esta función analiza todos los argumentos, los argumentos coincidentes con etiquetas y deja el tipo (índice de etiqueta) de cada argumento de la matriz pdwTagType , donde pdwTagType[0] corresponde al tipo de ppwcArguments[dwCurrentIndex]. La función PreprocessCommand también garantiza que las etiquetas necesarias para estar presentes están presentes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	netsh.h
Library	Netsh.lib
Archivo DLL	Netsh.exe

Consulte también

FN_HANDLE_CMD

TAG_TYPE