OV_Action::CreateAsWScript()
OV_Action::CreateAsWScript_Trans()
- OV_Action CreateAsWScript(
- [in] string Script,
- [in] string Caption,
- [in, optional] string ParentName,
- [in, optional] string Name,
- [in, optional] string Description,
- [in, optional] uint16 ExecuteOn,
- [in, optional] sint32 IOType,
- [in, optional] boolean EditLogin,
- [in, optional] string ExecuteAsUser,
- [in, optional] boolean RequirePassword,
- [in, optional] string Password,
- [in, optional] string PredefinedList[] )
- OV_Action CreateAsWScript_Trans(
- [in] string TransId,
- [in] string Script,
- [in] string Caption,
- [in, optional] string ParentName,
- [in, optional] string Name,
- [in, optional] string Description,
- [in, optional] uint16 ExecuteOn,
- [in, optional] sint32 IOType,
- [in, optional] boolean EditLogin,
- [in, optional] string ExecuteAsUser,
- [in, optional] boolean RequirePassword,
- [in, optional] string Password,
- [in, optional] string PredefinedList[] )
Parameters
- TransId
- Transaction ID returned from OV_Transaction::Start().
- Script
- Contains a WScript.
- Caption
- Caption (Display Name). If a tool with the same Caption/Display
is already a child of the parent tool group, nothing happens, and
the method fails with MDLAPI_E_TOOL_HIERPATH_EXISTS. If the Caption
parameter is an empty string, contains invalid characters, or has
more than 1024 characters, the method fails with
MDLAPI_E_INVALID_CAPTION.
- ParentName
- The Name property of an instance of OV_Tools to which the newly
created tool is added. Optional parameter. If you do not specify
the parameter, or if it is equal to an empty string, the root tool
group is used. If the specified tool group does not exist, the
method fails with MDLAPI_E_PARENT_TOOLGROUP_NOT_EXIST.
- Name
- The Name property of an instance of OV_Action to be created.
Optional parameter. If you do not specify the parameter, or if it
is equal to an empty string, it is created as a new GUID. If a tool
with the same Name already exists, nothing happens, and the method
fails with MDLAPI_E_TOOL_NAME_EXISTS.
- Description
- Copied to the Description property. Optional parameter.
- ExecuteOn
- Copied to the ExecuteOn property. Optional parameter. Default
is 0 ("Management Server").
- IOType
- Copied to the IOType property. Optional parameter. Default is 0
("NoOutput").
- EditLogin
- Copied to the EditLogin property. Optional parameter. Default
is false.
- ExecuteAsUser
- Copied to the ExecuteAsUser property. Optional parameter.
- RequirePassword
- Copied to the RequirePassword property. Optional parameter.
Default is false.
- Password
- Copied to the Password property. This parameter is applicable
only when RequirePassword is equal to true. Optional
parameter.
- PredefinedList
- Copied to PredefinedList property. This parameter is applicable
only when ExecuteOn is equal to 2 ("Node List"). Optional
parameter.
Calling Convention
These methods can be called from a WMI class or instance
object.
Description
Creates a tool (new instance of OV_Action) as a WScript, and
adds it to an existing tool group (instance of OV_Tools).
All parameters are validated before the tool is actually
generated. If any parameter does not match, the method fails with
MDLAPI_E_INVALID_PARAMETER.
Return Value
Instance of the newly created OV_Action.
Extended Status Codes
- MDLAPI_E_INVALID_PARAMETER
- Parameter is not valid.
- MDLAPI_E_INVALID_CAPTION
- Specified object Caption parameter is not valid.
- MDLAPI_E_TOOL_NAME_EXISTS
- Tool with the same Name already exists.
- MDLAPI_E_TOOL_HIERPATH_EXISTS
- Tool with the same Caption is already a child of the parent
tool group.
- MDLAPI_E_PARENT_TOOLGROUP_NOT_EXIST
- Parent Tool Group does not exist.
- MDLAPI_E_TRANSACTION_NOT_EXIST
- Transaction with the specified ID does not exist.