Método IDirectManipulationContent::GetTag (directmanipulation.h)
Recupera el objeto de etiqueta establecido en este contenido.
Sintaxis
HRESULT GetTag(
[in] REFIID riid,
[out, optional] void **object,
[out, optional] UINT32 *id
);
Parámetros
[in] riid
Referencia al identificador de la interfaz que se va a usar. El objeto de etiqueta normalmente implementa esta interfaz.
[out, optional] object
Objeto de etiqueta.
[out, optional] id
Parte del identificador de la etiqueta.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
GetTag y SetTag son útiles para asociar un objeto COM externo con el contenido sin una asignación externa entre los dos. También se pueden usar para pasar información a devoluciones de llamada generadas para el contenido.
GetTag consulta el valor de etiqueta de la interfaz especificada y devuelve un puntero a esa interfaz.
Una etiqueta es un emparejamiento de un identificador entero (id) con un objeto Component Object Model (COM). Una aplicación puede usarla para identificar un movimiento. Los parámetros son opcionales, de modo que el método pueda devolver ambas partes de la etiqueta, la parte del identificador o el objeto tag.
Ejemplos
En el ejemplo siguiente se muestra la sintaxis de este método.
IUnknown* pObject;
UINT32 id;
HRESULT hr = pContent->GetTag(IID_PPV_ARGS(&pObject), &id);
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | directmanipulation.h |