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

아티클
08/07/2023

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 패키지 이름 및 명령줄을 포함하여 프로세스에 대한 추가 정보를 받습니다. Description이 NULL이면 이 정보가 반환되지 않습니다.

[in] DescriptionSize

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

[out, optional] ActualDescriptionSize

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

반환 값

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

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