IPackageDebugSettings::EnableDebugging method

  • Article

Enables debug mode for the processes of the specified package.

Syntax

HRESULT EnableDebugging(
  [in] LPCWSTR packageFullName,
  [in] LPCWSTR debuggerCommandLine,
  [in] PZZWSTR environment
);

Parameters

  • packageFullName [in]
    Type: LPCWSTR

    The package full name.

  • debuggerCommandLine [in]
    Type: LPCWSTR

    The command line to use to launch processes from this package. This parameter is optional.

  • environment [in]
    Type: PZZWSTR

    Any environment strings to pass to processes. This parameter is optional.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Enabling debug mode has the following effects:

  • Optionally enables debugger attach on activation.
  • Disables activation timeouts.
  • Disables automatic process suspension.
  • Disables automatic process termination.
  • Disables automatic process resumption.

To restore normal operation, call the DisableDebugging method.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

 Shobjidl_core.h

IDL

 Shobjidl.idl

See also

IPackageDebugSettings