Compartir a través de

método Msvm_CopyFileToGuestJob::RequestStateChange

  • Artículo

Cambia el estado del trabajo.

Sintaxis

uint32 RequestStateChange(
  [in] uint16   RequestedState,
  [in] datetime TimeoutPeriod
);

Parámetros

RequestedState [in]

El nuevo estado. Estos son los valores posibles:

Inicio (2)

Cambia el estado a "En ejecución".

Suspender (3)

Detiene el trabajo temporalmente. A continuación, el cliente puede reiniciar el trabajo con "Start". El cliente puede especificar el estado "Servicio" mientras está suspendido (esto es específico del trabajo).

Finalizar (4)

Detiene el trabajo de forma limpia, guardando datos, conservando el estado y cerrando todos los procesos subyacentes de forma ordenada.

Matar (5)

Finaliza el trabajo inmediatamente sin necesidad de guardar datos ni conservar el estado.

Servicio (6)

Coloca el trabajo en un estado de servicio específico del proveedor. Posiblemente, el cliente puede reiniciar el trabajo.

DMTF Reserved (7..32767)

Proveedor reservado (32768..65535)

TimeoutPeriod [in]

Período de tiempo de espera que especifica la cantidad máxima de tiempo que el cliente espera que tarde la transición al nuevo estado. El formato de intervalo debe usarse para especificar el período de tiempo de espera. Un valor de 0 o Null indica que el cliente no tiene requisitos de tiempo para la transición. Si esta propiedad no contiene 0 o Null y la implementación no admite este parámetro, se debe devolver un código de retorno de 4098 (uso del parámetro timeout no admitido).

Valor devuelto

Este método devuelve uno de los valores siguientes.

Código o valor devuelto Descripción
Completado sin error
0
 Correcto.
No se admite el uso del parámetro timeout
4098
Erróneo
32 768
Acceso denegado
32769
 Acceso denegado.
No compatible
32770
El estado es desconocido
32771
Tiempo de espera
32772
Parámetro no válido
32773
El sistema está en uso
32774
Estado no válido para esta operación
32775
 No se admite el valor especificado en el parámetro RequestedState .
Tipo de datos incorrecto
32776
El sistema no está disponible
32777
Memoria insuficiente
32778

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2012 R2 [solo aplicaciones de escritorio]
Espacio de nombres
 \\Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
Archivo DLL
Vmms.exe

Consulte también

Msvm_CopyFileToGuestJob