3.2.4.2.9.10 MonitorCommand (put) (Opnum 21)

  • Article

The MonitorCommand (put) method sets the monitor command property of the action. The monitor command property determines if the File Server Resource Manager Protocol will monitor the executable it starts if the action runs.

 [propput, id(FSRM_PROPERTY(FSRM_DISPID_ACTION_COMMAND | 0x05))] HRESULT MonitorCommand(
   [in] VARIANT_BOOL monitorCommand
 );

monitorCommand: Contains a Boolean value for the monitor command property for this action.

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80070057

E_INVALIDARG

The monitorCommand parameter is not a valid variant type. If monitorCommand is not VT_BOOL, the parameter is an invalid type.

The server MUST use monitorCommand to determine if it will monitor the action's executable if it is run or return a nonzero error code.

If monitorCommand equals VARIANT_TRUE, the server MUST wait for the number of minutes specified in the KillTimeout property. If the command is still running after that time, the server will terminate the process that is running the executable.

If monitorCommand equals VARIANT_FALSE, the server MUST NOT monitor the process running the executable.