DebugPrefix Property for Resources

The DebugPrefix property provides the path to the debugger to be attached to the Resource Monitor for the resource.

Quick Info

Type: Null-terminated Unicode string
Access: Read/write
Function: ClusterResourceControl
Structure: CLUSPROP_SZ
Control Code: CLUSCTL_RESOURCE_GET_COMMON_PROPERTIES

Remarks

When ClusterResourceControl processes the CLUSCTL_RESOURCE_GET_COMMON_PROPERTIES control code, it returns a property list that includes the DebugPrefix property as one of the entries. The property value portion of the entry contains a CLUSPROP_SZ structure that is set as follows:

CLUSPROP_SZ DebugPrefixValue;
LPCWSTR DebugPrefixData = L "C:\bin\debug.exe";
DebugPrefixValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_SZ;
DebugPrefixValue.cbLength = sizeof(DebugPrefixData);
lstrcpyW(DebugPrefixValue.sz, DebugPrefixData);
 

A debugger can be used only if the resource is running with a separate Resource Monitor. If the debugger is in a directory that is included in the path, DebugPrefix can be set to a relative path. Otherwise, a full path must be specified.

Setting the DebugPrefix property causes -p <process id> to be appended to the end of the debug command, where <process id> represents the process identifier for the Resource Monitor handling the resource.

For more information about Resource Monitors, see Resource Monitor.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.