Método IDirectManipulationContent::GetTag (directmanipulation.h)
Recupera o conjunto de objetos de marca neste conteúdo.
Sintaxe
HRESULT GetTag(
[in] REFIID riid,
[out, optional] void **object,
[out, optional] UINT32 *id
);
Parâmetros
[in] riid
Uma referência ao identificador da interface a ser usada. Normalmente, o objeto de marca implementa essa interface.
[out, optional] object
O objeto de marca.
[out, optional] id
A parte da ID da marca.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
GetTag e SetTag são úteis para associar um objeto COM externo ao conteúdo sem um mapeamento externo entre os dois. Eles também podem ser usados para passar informações para retornos de chamada gerados para o conteúdo.
GetTag consulta o valor da marca para a interface especificada e retorna um ponteiro para essa interface.
Uma marca é um emparelhamento de uma ID de inteiro (id) com um objeto COM (Component Object Model). Ele pode ser usado por um aplicativo para identificar um movimento. Os parâmetros são opcionais, de modo que o método possa retornar ambas as partes da marca, a parte do identificador ou o objeto de marca.
Exemplos
O exemplo a seguir mostra a sintaxe desse método.
IUnknown* pObject;
UINT32 id;
HRESULT hr = pContent->GetTag(IID_PPV_ARGS(&pObject), &id);
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | directmanipulation.h |