다음을 통해 공유

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

  • 아티클

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

구문

HRESULT GetComponentsInProcess(
  [in]  REFGUID          ApplicationInstanceId,
  [in]  DWORD            ProcessId,
  [in]  REFGUID          PartitionId,
  [in]  REFGUID          ApplicationId,
  [in]  DWORD            Flags,
  [out] ULONG            *NumComponentsInProcess,
  [out] ComponentSummary **Components
);

매개 변수

[in] ApplicationInstanceId

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

[in] ProcessId

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

[in] PartitionId

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

[in] ApplicationId

결과를 필터링하거나 모든 애플리케이션에 대해 GUID_NULL 애플리케이션 ID입니다.

[in] Flags

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

[out] NumComponentsInProcess

반환될 때 PartitionId, ApplicationId 및 Flags에 지정된 필터 조건과 일치하는 프로세스의 구성 요소 수입니다.

[out] Components

반환할 때 일치하는 구성 요소에 대한 ComponentSummary 구조체의 배열입니다.

반환 값

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

반환 코드 Description
S_OK
 메서드가 성공적으로 완료되고 결과는 Components 매개 변수에 있습니다.
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 설정된 경우 결과에는 구성 요소 없는 서비스 컨텍스트에 대한 항목도 포함됩니다.

ApplicationId를 사용하여 애플리케이션을 지정하는 경우(GUID_NULL 설정되지 않음) GATD_INCLUDE_LIBRARY_APPS 및 GATD_INCLUDE_SWC 플래그는 의미가 없으며 사용하는 것은 유효하지 않습니다. 지정된 애플리케이션의 구성 요소는 해당 애플리케이션의 형식에 관계없이 반환됩니다.

요구 사항

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

추가 정보

IGetAppTrackerData