estructura CMD_GROUP_ENTRY (netsh.h)

la estructura CMD_GROUP_ENTRY define un grupo de comandos auxiliares.

Sintaxis

typedef struct _CMD_GROUP_ENTRY {
  LPCWSTR            pwszCmdGroupToken;
  DWORD              dwShortCmdHelpToken;
  ULONG              ulCmdGroupSize;
  DWORD              dwFlags;
  PCMD_ENTRY         pCmdGroup;
  PNS_OSVERSIONCHECK pOsVersionCheck;
} CMD_GROUP_ENTRY, *PCMD_GROUP_ENTRY;

Miembros

pwszCmdGroupToken

Token (nombre) del grupo de comandos

dwShortCmdHelpToken

Un breve mensaje de ayuda.

ulCmdGroupSize

Número de elementos del grupo de comandos.

dwFlags

Banderas. Para obtener más información, consulte Marcas de NetShell.

pCmdGroup

Matriz de estructuras de CMD_ENTRY.

pOsVersionCheck

Función de comprobación de la versión del sistema operativo. Esta es la función que se usa para determinar si el comando se puede ejecutar en el sistema operativo que se ejecuta en el contexto local o remoto antes de invocar o mostrar comandos. Para obtener más información, consulte NS_OSVERSIONCHECK.

Comentarios

Hay macros disponibles que pueden simplificar la creación de la estructura de CMD_GROUP_ENTRY , como se indica a continuación:

#define CREATE_CMD_GROUP_ENTRY_EX(t,s,i)       {CMD_##t, HLP_##t, sizeof(s)/sizeof(CMD_ENTRY), i, s, NULL }
#define CREATE_CMD_GROUP_ENTRY_EX_VER(t,s,i,v) {CMD_##t, HLP_##t, sizeof(s)/sizeof(CMD_ENTRY), i, s, v }
#define CREATE_CMD_GROUP_ENTRY(t,s)            {CMD_##t, HLP_##t, sizeof(s)/sizeof(CMD_ENTRY), 0, s, NULL }

Si se usan estas macros, se deben definir las siguientes constantes en el archivo DLL del asistente:

A continuación se muestran los usos de estas macros de ejemplo:

#define HLP_GROUP_ADD        1100
#define HLP_GROUP_ADD_EX     1101
#define HLP_GROUP_DELETE     1102
#define HLP_GROUP_DELETE_EX  1103
#define HLP_GROUP_SET        1104
#define HLP_GROUP_SET_EX     1105
#define HLP_GROUP_SHOW       1106
#define HLP_GROUP_SHOW_EX    1107

#define CMD_GROUP_ADD        L"add"
#define CMD_GROUP_DELETE     L"delete"
#define CMD_GROUP_SET        L"set"
#define CMD_GROUP_SHOW       L"show"

static CMD_GROUP_ENTRY g_SampleGroupCmds[] = 
{
    CREATE_CMD_GROUP_ENTRY(GROUP_ADD,    g_SampleAddCmdTable),
    CREATE_CMD_GROUP_ENTRY(GROUP_DELETE, g_SampleDeleteCmdTable),
    CREATE_CMD_GROUP_ENTRY(GROUP_SET,    g_SampleSetCmdTable),
    CREATE_CMD_GROUP_ENTRY(GROUP_SHOW,   g_SampleShowCmdTable),
};

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado netsh.h

Consulte también

CMD_ENTRY

NS_CONTEXT_COMMIT_FN

Marcas de NetShell

  • Last updated on