IDebugClient4::GetRunningProcessDescription 메서드(dbgeng.h)

GetRunningProcessDescription 메서드는 실행 파일 이미지 이름, 서비스 이름, MTS 패키지 이름 및 명령줄을 포함하는 프로세스에 대한 설명을 반환합니다.

통사론

HRESULT GetRunningProcessDescription(
  [in]            ULONG64 Server,
  [in]            ULONG   SystemId,
  [in]            ULONG   Flags,
  [out, optional] PSTR    ExeName,
  [in]            ULONG   ExeNameSize,
  [out, optional] PULONG  ActualExeNameSize,
  [out, optional] PSTR    Description,
  [in]            ULONG   DescriptionSize,
  [out, optional] PULONG  ActualDescriptionSize
);

매개 변수

[in] Server

프로세스 설명을 쿼리할 프로세스 서버를 지정합니다. Server 0이면 엔진은 로컬 프로세스에 대한 정보를 직접 쿼리합니다.

[in] SystemId

설명이 필요한 프로세스의 프로세스 ID를 지정합니다.

[in] Flags

이 메서드의 동작에 영향을 주는 옵션을 포함하는 비트 집합을 지정합니다. 플래그 다음 비트 플래그를 포함할 수 있습니다.

기	묘사
DEBUG_PROC_DESC_NO_PATHS	경로 이름이 없는 파일 이름만 반환합니다.
DEBUG_PROC_DESC_NO_SERVICES	서비스 이름을 조회하지 마세요.
DEBUG_PROC_DESC_NO_MTS_PACKAGES	MTS 패키지 이름을 조회하지 마세요.
DEBUG_PROC_DESC_NO_COMMAND_LINE	명령줄을 검색하지 마세요.

[out, optional] ExeName

프로세스를 시작하는 데 사용되는 실행 파일의 이름을 받습니다. ExeName NULL 경우 이 정보가 반환되지 않습니다.

[in] ExeNameSize

ExeNameSize 버퍼의 문자 크기를 지정합니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다.

[out, optional] ActualExeNameSize

실행 파일 이름의 문자로 크기를 받습니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다. ExeNameSize NULL 경우 이 정보가 반환되지 않습니다.

[out, optional] Description

서비스 이름, MTS 패키지 이름 및 명령줄을 포함하여 프로세스에 대한 추가 정보를 받습니다. 설명 NULL 경우 이 정보는 반환되지 않습니다.

[in] DescriptionSize

설명 버퍼의 문자 크기를 지정합니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다.

[out, optional] ActualDescriptionSize

추가 정보의 문자로 크기를 받습니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다. actualDescriptionSize NULL 경우 이 정보가 반환되지 않습니다.

반환 값

이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값 참조하세요.

반환 코드	묘사
S_OK	메서드가 성공했습니다.
S_FALSE	메서드가 성공했습니다. 그러나 ExeNameSize 또는 DescriptionSize 해당 문자열의 크기보다 작으며 버퍼 내에 맞게 문자열이 잘렸습니다.

발언

이 메서드는 라이브 사용자 모드 디버깅에만 사용할 수 있습니다.

라이브 사용자 모드 대상을 만들고 연결하는 방법에 대한 자세한 내용은 Live User-Mode 대상참조하세요.

요구 사항

요구	값
대상 플랫폼	바탕 화면
헤더	dbgeng.h(Dbgeng.h 포함)

참고 항목

attachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessSystemIdByExecutableName

GetRunningProcessSystemIds

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5