DebugPrefix Property for Resource Types

The DebugPrefix property provides the path to a debugger that will be used to debug all resources of the type that are running in the Resource Monitor for the resource type.

Quick Info

Type: Null-terminated Unicode string
Access: Read/write
Function: ClusterResourceTypeControl
Structures: CLUSPROP_SZ
Control Codes: CLUSCTL_RESOURCE_TYPE_GET_COMMON_PROPERTIES

Remarks

When ClusterResourceTypeControl processes the CLUSCTL_RESOURCE_TYPE_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:

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

A debugger can be used only if the resource type 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 type.

QuickInfo

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