다음을 통해 공유


IExtendTaskPad::GetBackground 메서드(mmc.h)

IExtendTaskPad::GetBackground 메서드를 사용하면 MMC가 작업 패드 템플릿을 사용하는 작업 패드에 표시할 작업 패드의 배경 이미지를 가져올 수 있습니다.

구문

HRESULT GetBackground(
  [in]  LPOLESTR                pszGroup,
  [out] MMC_TASK_DISPLAY_OBJECT *pTDO
);

매개 변수

[in] pszGroup

작업 패드를 식별하는 그룹 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 그룹 이름은 MMC가 IComponent::GetResultViewType을 호출하여 작업 패드를 표시할 때 ppViewType 매개 변수에 전달된 문자열의 해시(#)를 따르는 문자열입니다. 그룹 이름을 지정하지 않으면 pszGroup은 NULL 문자열입니다.

[out] pTDO

pszGroup에서 지정한 작업 패드의 배경으로 표시할 이미지를 지정하기 위해 스냅인에서 채워야 하는 MMC_TASK_DISPLAY_OBJECT 구조체에 대한 포인터입니다.

호출자(MMC)는 MMC_TASK_DISPLAY_OBJECT 구조에 대한 메모리를 할당합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

COM API 함수 CoTaskMemAlloc (또는 이에 상응하는)을 사용하여 pTDO 매개 변수에 지정된 MMC_TASK_DISPLAY_BITMAP 또는 MMC_TASK_DISPLAY_SYMBOL 구조체에 문자열을 할당하면 MMC가 이를 해제합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 mmc.h

참고 항목

IExtendTaskPad

MMC_TASK_DISPLAY_BITMAP

MMC_TASK_DISPLAY_OBJECT

MMC_TASK_DISPLAY_SYMBOL