The GetRunningProcessDescription method returns a description of the process that includes the executable image name, the service names, the MTS package names, and the command line.
HRESULT GetRunningProcessDescription( ULONG64 Server, ULONG SystemId, ULONG Flags, PSTR ExeName, ULONG ExeNameSize, PULONG ActualExeNameSize, PSTR Description, ULONG DescriptionSize, PULONG ActualDescriptionSize );
Specifies the process server to query for the process description. If Server is zero, the engine will query information about the local process directly.
Specifies the process ID of the process whose description is desired.
Specifies a bit-set containing options that affect the behavior of this method. Flags can contain the following bit flags:
|DEBUG_PROC_DESC_NO_PATHS||Return only file names without path names.|
|DEBUG_PROC_DESC_NO_SERVICES||Do not look up service names.|
|DEBUG_PROC_DESC_NO_MTS_PACKAGES||Do not look up MTS package names.|
|DEBUG_PROC_DESC_NO_COMMAND_LINE||Do not retrieve the command line.|
Receives the name of the executable file used to start the process. If ExeName is NULL, this information is not returned.
Specifies the size in characters of the buffer ExeNameSize.
Receives the size in characters of the executable file name. If ExeNameSize is NULL, this information is not returned.
Receives extra information about the process, including service names, MTS package names, and the command line. If Description is NULL, this information is not returned.
Specifies the size in characters of the buffer Description.
Receives the size in characters of the extra information. If ActualDescriptionSize is NULL, this information is not returned.
This method may also return error values. See Return Values for more details.
||The method was successful.|
||The method was successful. However, either ExeNameSize or DescriptionSize were smaller than the size of the respective string and the string was truncated to fit inside the buffer.|
This method is available only for live user-mode debugging.
For more information about creating and attaching to live user-mode targets, see Live User-Mode Targets.
|Header||dbgeng.h (include Dbgeng.h)|