Export (0) Print
Expand All

IFsrmActionCommand::ExecutablePath property

[This property is supported for compatibility but it's recommended to use the FSRM WMI Classes to manage FSRM. Please see the MSFT_FSRMAction, MSFT_FSRMFMJAction, and MSFT_FSRMFMJNotificationAction classes.]

Retrieves or sets the full path to the executable program or script to run.

This property is read/write.

Syntax


HRESULT put_ExecutablePath(
  [in]   BSTR executablePath
);

HRESULT get_ExecutablePath(
  [out]  BSTR *executablePath
);

Property value

The full path to the executable program or script to run. The path can contain environment variables. The string is limited to MAX_PATH characters.

Error codes

The method returns the following return values.

NameMeaning
S_OK

Success.

E_INVALIDARG

The executablePath parameter is NULL.

FSRM_E_OUT_OF_RANGE

The path is too long.

FSRM_E_INVALID_PATH

The path is not valid or is not a file.

FSRM_E_LONG_CMDLINE

The command is too long after expanding environment variables in the path.

FSRM_E_INSECURE_PATH

Only local system, administrator, and power users can have write access to the path.

Remarks

The path must exist at the time you set the property and when the command executes. If the path does not exist when the command executes, FSRM writes an event to the Application log.

To execute the command, the user that configured the action must exist in the Administrators group at the time the command is executed.

Only administrators can have write access to all folders in the path at the time you set the property and when the command executes. If others have write access when the command executes, FSRM does not execute the command and writes an event to the Application log.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008

Header

Fsrm.h (include FsrmQuota.h or FsrmScreen.h)

DLL

SrmSvc.dll

IID

IID_IFsrmActionCommand is defined as 12937789-e247-4917-9c20-f3ee9c7ee783

See also

IFsrmActionCommand
MSFT_FSRMAction
MSFT_FSRMFMJAction
MSFT_FSRMFMJNotificationAction

 

 

Show:
© 2014 Microsoft