Metodo IDirectManipulationContent::GetTag (directmanipulation.h)

Articolo
02/26/2024

Recupera l'oggetto tag impostato su questo contenuto.

Sintassi

HRESULT GetTag(
  [in]            REFIID riid,
  [out, optional] void   **object,
  [out, optional] UINT32 *id
);

Parametri

[in] riid

Riferimento all'identificatore dell'interfaccia da usare. L'oggetto tag implementa in genere questa interfaccia.

[out, optional] object

Oggetto tag.

[out, optional] id

Parte ID del tag.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

GetTag e SetTag sono utili per associare un oggetto COM esterno al contenuto senza un mapping esterno tra i due. Possono essere usati anche per passare informazioni ai callback generati per il contenuto.

GetTag esegue una query sul valore del tag per l'interfaccia specificata e restituisce un puntatore a tale interfaccia.

Un tag è una coppia di un ID intero (ID) con un oggetto Component Object Model (COM) (oggetto). Può essere usato da un'app per identificare un movimento. I parametri sono facoltativi, in modo che il metodo possa restituire entrambe le parti del tag, la parte identificatore o l'oggetto tag.

Esempio

Nell'esempio seguente viene illustrata la sintassi per questo metodo.

IUnknown* pObject;
UINT32 id;

HRESULT hr = pContent->GetTag(IID_PPV_ARGS(&pObject), &id);

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	directmanipulation.h

Vedi anche

IDirectManipulationContent

Condividi tramite