IDirectManipulationContent::GetTag-Methode (directmanipulation.h)
Ruft das für diesen Inhalt festgelegte Tagobjekt ab.
Syntax
HRESULT GetTag(
[in] REFIID riid,
[out, optional] void **object,
[out, optional] UINT32 *id
);
Parameter
[in] riid
Ein Verweis auf den Bezeichner der zu verwendenden Schnittstelle. Das Tagobjekt implementiert in der Regel diese Schnittstelle.
[out, optional] object
Das Tagobjekt.
[out, optional] id
Der ID-Teil des Tags.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
GetTag und SetTag sind nützlich, um dem Inhalt ein externes COM-Objekt ohne externe Zuordnung zwischen den beiden zuzuordnen. Sie können auch verwendet werden, um Informationen an Rückrufe zu übergeben, die für den Inhalt generiert werden.
GetTag fragt den Tagwert für die angegebene Schnittstelle ab und gibt einen Zeiger auf diese Schnittstelle zurück.
Ein Tag ist eine Kopplung einer ganzzahligen ID (ID) mit einem COM-Objekt (Component Object Model) (Objekt). Es kann von einer App verwendet werden, um eine Bewegung zu identifizieren. Die Parameter sind optional, sodass die Methode beide Teile des Tags, den Bezeichnerteil oder das Tagobjekt zurückgeben kann.
Beispiele
Das folgende Beispiel zeigt die Syntax für diese Methode.
IUnknown* pObject;
UINT32 id;
HRESULT hr = pContent->GetTag(IID_PPV_ARGS(&pObject), &id);
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | directmanipulation.h |