다음을 통해 공유


IDebugClient5::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

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

[in] ExeNameSize

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

[out, optional] ActualExeNameSize

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

[out, optional] Description

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

[in] DescriptionSize

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

[out, optional] ActualDescriptionSize

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

반환 값

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

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

설명

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

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

요구 사항

요구 사항
대상 플랫폼 데스크톱
머리글 dbgeng.h(Dbgeng.h 포함)

추가 정보

AttachProcess

ConnectProcessServer

CreateProcessAndAttach2

GetRunningProcessSystemIdByExecutableName

GetRunningProcessSystemIds

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5