IDirectManipulationContent::GetTag 메서드(directmanipulation.h)
이 콘텐츠에 설정된 태그 개체를 검색합니다.
구문
HRESULT GetTag(
[in] REFIID riid,
[out, optional] void **object,
[out, optional] UINT32 *id
);
매개 변수
[in] riid
사용할 인터페이스의 식별자에 대한 참조입니다. 태그 개체는 일반적으로 이 인터페이스를 구현합니다.
[out, optional] object
태그 개체입니다.
[out, optional] id
태그의 ID 부분입니다.
반환 값
메서드가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
GetTag 및 SetTag 는 둘 사이의 외부 매핑 없이 외부 COM 개체를 콘텐츠와 연결할 때 유용합니다. 콘텐츠에 대해 생성된 콜백에 정보를 전달하는 데 사용할 수도 있습니다.
GetTag 는 지정된 인터페이스에 대한 태그 값을 쿼리하고 해당 인터페이스에 대한 포인터를 반환합니다.
태그는 COM(Component Object Model) 개체(개체)와 정수 ID(id)를 페어링하는 것입니다. 앱에서 동작을 식별하는 데 사용할 수 있습니다. 매개 변수는 선택 사항이므로 메서드는 태그, 식별자 부분 또는 태그 개체의 두 부분을 모두 반환할 수 있습니다.
예제
다음 예제에서는이 메서드에 대 한 구문을 보여 있습니다.
IUnknown* pObject;
UINT32 id;
HRESULT hr = pContent->GetTag(IID_PPV_ARGS(&pObject), &id);
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | directmanipulation.h |