IDirectManipulationViewport::GetTag-Methode (directmanipulation.h)
Ruft den Tagwert eines Viewports ab.
Syntax
HRESULT GetTag(
[in] REFIID riid,
[out, optional] void **object,
[out, optional] UINT32 *id
);
Parameter
[in] riid
IID für die Schnittstelle.
[out, optional] object
Der Objektteil des Tags.
[out, optional] id
Der Bezeichnerteil des Tags.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Ein Tag ist eine Kopplung einer ganzzahligen ID mit einem COM-Objekt (Component Object Model). Sie kann von einer App verwendet werden, um den Viewport zu identifizieren.
Die out-Parameter sind optional, sodass die Methode eine ID, das Viewport-Objekt oder beides zurückgeben kann.
Beispiele
Im folgenden Beispiel wird die Verwendung dieser Methode veranschaulicht.
IUnknown* pUnk;
UINT32 id;
HRESULT hr = pRegion->GetTag(IID_PPV_ARGS(&pUnk), &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 |