estructura de WSMAN_PLUGIN_REQUEST (wsman.h)

Especifica información para una solicitud de complemento. Un puntero a una estructura de WSMAN_PLUGIN_REQUEST se pasa a todos los puntos de entrada de operación dentro del complemento. Todos los métodos de notificación de resultados usan este puntero para que coincida con el resultado con la solicitud. Toda la información de la estructura permanecerá válida hasta que el complemento llame a WSManPluginOperationComplete en la operación.

Sintaxis

typedef struct _WSMAN_PLUGIN_REQUEST {
  WSMAN_SENDER_DETAILS *senderDetails;
  PCWSTR               locale;
  PCWSTR               resourceUri;
  WSMAN_OPERATION_INFO *operationInfo;
  BOOL                 shutdownNotification;
  HANDLE               shutdownNotificationHandle;
  PCWSTR               dataLocale;
} WSMAN_PLUGIN_REQUEST;

Miembros

senderDetails

Puntero a una estructura de WSMAN_SENDER_DETAILS que especifica los detalles sobre el cliente que inició la solicitud.

locale

Especifica la configuración regional en la que el usuario solicitó resultados. Si la configuración regional solicitada no está disponible, están disponibles las siguientes opciones:

• Se usa la configuración regional del sistema.
• La solicitud se rechaza con un error de configuración regional no válido.

Cualquier llamada al complemento tendrá la configuración regional en el subproceso establecido en la configuración regional especificada en este miembro. Si el complemento tiene otros subprocesos que funcionan en la solicitud, el complemento deberá establecer la configuración regional en consecuencia en cada subproceso que use.

resourceUri

Especifica el URI del recurso para esta operación.

operationInfo

Puntero a una estructura de WSMAN_OPERATION_INFO que contiene información adicional sobre la operación. Parte de la información de esta estructura será NULL porque no todos los parámetros son relevantes para todas las operaciones.

shutdownNotification

Si se cancela la operación, el miembro shutdownNotification se establece en TRUE.

shutdownNotificationHandle

Si se cancela la operación, se señala shutdownNotification .

dataLocale

Comentarios

Las operaciones deben indicar la devolución de llamada de la operación para indicar que se ha apagado. Las operaciones se cancelan de forma jerárquica para asegurarse de que todas las operaciones de seguimiento se cancelan antes de las operaciones de nivel superior. Un complemento tiene dos maneras de controlar la cancelación de una operación. En primer lugar, el complemento puede comprobar el valor booleano shutdownNotification si recorre en iteración un conjunto de resultados. En segundo lugar, si el complemento es más asincrónico por naturaleza, se puede usar shutdownNotificationHandle al poner en cola subprocesos de notificación asincrónicos.

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