ISharedBitmap::D etach-Methode (thumbcache.h)

Ruft die in einem ISharedBitmap-Objekt enthaltene Bitmap ab und gibt eine Kopie zurück, wenn sich die enthaltene Bitmap im freigegebenen Speicher befindet. Nach dem Aufrufen dieser Methode ist die Bitmap dieser ISharedBitmap nicht mehr zugeordnet, und Sie können ISharedBitmap::GetSharedBitmap oder ISharedBitmap::D etach nicht mehr aufrufen.

Syntax

HRESULT Detach(
  [out] HBITMAP *phbm
);

Parameter

[out] phbm

Typ: HBITMAP*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein Handle auf die abzurufende Bitmap.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn sich die abgerufene Bitmap im freigegebenen Speicher befindet, wird eine Kopie der Bitmap zurückgegeben. Die Detach-Methode gibt keine Verweise auf den zugrunde liegenden freigegebenen Arbeitsspeicher frei.

Wenn sich die abgerufene Bitmap nicht im freigegebenen Speicher befindet, wird die Bitmap selbst zurückgegeben, und es wird keine Kopie erstellt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	thumbcache.h