NS_CONTEXT_CONNECT_FN función de devolución de llamada (netsh.h)

El comando NS_CONTEXT_CONNECT_FN es la función connect para asistentes. Los asistentes exponen una función de conexión que permite a NetShell conectarse al asistente. NetShell llama a una función auxiliar de conexión antes de llamar a otras funciones auxiliares.

La función connect se registra con NetShell mediante la función RegisterContext . A continuación se muestra un ejemplo de una función connect. Tenga en cuenta que SampleConnect es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

NS_CONTEXT_CONNECT_FN NsContextConnectFn;

DWORD NsContextConnectFn(
  [in] LPCWSTR pwszMachine
)
{...}

Parámetros

[in] pwszMachine

Equipo en el que se va a realizar el comando, o null si el comando se aplica al equipo local. El valor predeterminado es null.

Valor devuelto

Devuelve NO_ERROR si se realiza correctamente. Cualquier otro valor devuelto indica un error.

Comentarios

NetShell llama a una función auxiliar connect antes de que NetShell llame a la función de volcado de contexto, si existe, y antes de cualquier función de comando. Se deben realizar dos operaciones durante una llamada de función de conexión.

Si el contexto es remota, especificado por ausencia de la marca de CMD_FLAG_LOCAL, la función connect debe aceptar el nombre del equipo en el que la función debe funcionar a continuación e intentar validar su capacidad de comunicarse con ese equipo.

Si los comandos de contexto son dinámicos, el contexto debe llamar de nuevo a RegisterContext con su último conjunto de comandos.

Cada asistente es responsable de mantener su propia conexión a equipos remotos. Si el acceso no es posible, un asistente debe mostrar un mensaje de error adecuado y debe producir un error en la función connect.

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

Consulte también

NS_HELPER_ATTRIBUTES

Marcas de NetShell

RegisterContext