estructura WSMAN_SHELL_STARTUP_INFO_V10 (wsman.h)
Define los parámetros de inicio del shell que se usarán con la función WSManCreateShell . El cliente debe asignar la estructura y pasarla a la función WSManCreateShell .
La configuración pasada a la función WSManCreateShell puede afectar directamente al comportamiento de un comando ejecutado dentro del shell. Un ejemplo típico es el argumento workingDirectory que describe el directorio de trabajo asociado a cada proceso, que el sistema operativo usa al intentar buscar archivos especificados mediante una ruta de acceso relativa.
En ausencia de requisitos específicos para la nomenclatura de flujos, los clientes y los servicios deben intentar usar STDIN para flujos de entrada, STDOUT para el flujo de salida predeterminado y STDERR para el flujo de salida de error o estado.
Sintaxis
typedef struct _WSMAN_SHELL_STARTUP_INFO_V10 {
WSMAN_STREAM_ID_SET *inputStreamSet;
WSMAN_STREAM_ID_SET *outputStreamSet;
DWORD idleTimeoutMs;
PCWSTR workingDirectory;
WSMAN_ENVIRONMENT_VARIABLE_SET *variableSet;
} WSMAN_SHELL_STARTUP_INFO_V10;
Miembros
inputStreamSet
Puntero a una estructura WSMAN_STREAM_ID_SET que especifica un conjunto de flujos de entrada para el shell. La implementación del shell puede omitir las secuencias que no están presentes en el filtro. Para el shell de Windows Cmd.exe, este valor debe ser L"stdin". Si el valor es NULL, la implementación usa una matriz con L"stdin" como valor predeterminado.
outputStreamSet
Puntero a una estructura de WSMAN_STREAM_ID_SET que especifica un conjunto de flujos de salida para el shell. La implementación del shell puede omitir las secuencias que no están presentes en el filtro. Para el shell de Windows cmd.exe, este valor debe ser L"stdout stderr". Si el valor es NULL, la implementación usa una matriz con L"stdout" y L"stderr" como valor predeterminado.
idleTimeoutMs
Especifica la duración máxima, en milisegundos, el shell permanecerá abierto sin ninguna solicitud de cliente. Cuando se supera la duración máxima, el shell se elimina automáticamente. Se puede establecer cualquier valor de 0 a 0xFFFFFFFF. Esta duración tiene un valor máximo especificado por la configuración de GPO de tiempo de espera de inactividad, si está habilitada o por la configuración local IdleTimeout. El valor predeterminado de la duración máxima en la configuración local o GPO es de 15 minutos. Sin embargo, un administrador del sistema puede cambiar este valor. Para usar el valor máximo de la configuración de GPO o local, el cliente debe especificar 0 (cero) en este campo. Si se usa un valor explícito entre 0 y 0xFFFFFFFF, se usa el valor mínimo entre el valor de API explícito y el valor de la configuración local o del GPO.
workingDirectory
Especifica el directorio inicial de un shell. Se usa con cualquier comando de ejecución. Si este miembro es un valor NULL , el equipo remoto usará un directorio predeterminado al ejecutar el comando. El protocolo subyacente trata un valor vacío como un valor omitido.
variableSet
Puntero a una estructura WSMAN_ENVIRONMENT_VARIABLE_SET que especifica una matriz de pares de nombre y valor de variable, que describen el entorno inicial del shell. El contenido de estos elementos es específico del shell y se puede definir en términos de otras variables de entorno. Si se pasa un valor NULL , se usa el entorno predeterminado en el lado servidor.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 7 |
Servidor mínimo compatible | Windows Server 2008 R2 |
Encabezado | wsman.h |
Redistribuible | Windows Management Framework en Windows Server 2008 con SP2, Windows Vista con SP1 y Windows Vista con SP2 |