IGetAppTrackerData::GetApplicationsInProcess 메서드(comsvcs.h)

단일 프로세스에서 호스트되는 모든 COM+ 애플리케이션 또는 이러한 애플리케이션의 지정된 하위 집합에 대한 요약 정보를 검색합니다.

구문

HRESULT GetApplicationsInProcess(
  [in]  REFGUID            ApplicationInstanceId,
  [in]  DWORD              ProcessId,
  [in]  REFGUID            PartitionId,
  [in]  DWORD              Flags,
  [out] ULONG              *NumApplicationsInProcess,
  [out] ApplicationSummary **Applications
);

매개 변수

[in] ApplicationInstanceId

애플리케이션은 선택할 추적된 프로세스를 고유하게 식별하는 GUID를 instance ProcessId 매개 변수가 선택 영역에 사용되는지 GUID_NULL.

[in] ProcessId

선택할 프로세스를 식별하는 프로세스 ID이거나 ApplicationInstanceId 가 선택 영역에 사용되는 경우 0입니다.

[in] PartitionId

결과를 필터링하거나 모든 파티션에 대해 GUID_NULL 파티션 ID입니다.

[in] Flags

결과를 필터링하고 반환되는 데이터를 선택하는 GetAppTrackerDataFlags 열거형의 플래그 조합입니다. 지원되는 플래그는 GATD_INCLUDE_LIBRARY_APPS, GATD_INCLUDE_SWC, GATD_INCLUDE_APPLICATION_NAME. 자세한 내용은 아래 설명을 참조하세요.

[out] NumApplicationsInProcess

반환될 때 PartitionId 및 Flags로 지정된 필터 조건과 일치하는 프로세스의 애플리케이션 수입니다.

[out] Applications

반환되는 경우 일치하는 애플리케이션에 대한 ApplicationSummary 구조의 배열입니다.

반환 값

이 메서드는 다음 값뿐만 아니라 E_INVALIDARG 및 E_OUTOFMEMORY 표준 반환 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 성공적으로 완료되었으며 결과는 Applications 매개 변수에 있습니다.
S_FALSE	메서드가 성공적으로 완료되었지만 필터 조건과 일치하는 프로세스가 없었습니다.
COMADMIN_E_APP_NOT_RUNNING	지정된 프로세스가 없거나 추적된 COM+ 애플리케이션을 호스팅하지 않습니다.

설명

프로세스는 애플리케이션 instance ID 또는 프로세스 ID로 선택할 수 있지만 둘 다 선택할 수는 없습니다. 프로세스가 종료된 후 프로세스 ID를 다시 사용할 수 있으므로 애플리케이션 instance ID로 선택하는 것이 좋습니다. 그러나 프로세스 ID별 선택은 프로그램에 대한 명령줄 인수와 같은 다른 원본에서 프로세스 ID를 가져오는 경우에 유용할 수 있습니다.

GATD_INCLUDE_LIBRARY_APPS 및 GATD_INCLUDE_SWC 모두 Flags에 설정되지 않은 경우 COM+ 서버 애플리케이션만 결과에 포함됩니다. GATD_INCLUDE_LIBRARY_APPS 설정되면 프로세스의 COM+ 라이브러리 애플리케이션(있는 경우)도 포함됩니다. GATD_INCLUDE_SWC 설정되고 프로세스가 하나 이상의 구성 요소 없는 서비스 컨텍스트를 호스팅하는 경우 결과에는 SWC 컨텍스트 요약이 포함된 단일 의사 애플리케이션 항목도 포함됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	comsvcs.h

추가 정보

IGetAppTrackerData