IPicture::get_Handle-Methode (ocidl.h)

  • Artikel

Ruft das Handle für das in diesem Bildobjekt verwaltete Bild an einer angegebenen Position ab.

Syntax

HRESULT get_Handle(
  [out] OLE_HANDLE *pHandle
);

Parameter

[out] pHandle

Ein Zeiger auf eine Variable, die das Handle empfängt. Der Aufrufer ist bei erfolgreicher Rückgabe für dieses Handle verantwortlich. Die Variable ist bei Einem Fehler auf NULL festgelegt.

Rückgabewert

Diese Methode unterstützt die standardmäßigen Rückgabewerte E_FAIL und E_OUTOFMEMORY sowie die folgenden Werte.

Rückgabecode BESCHREIBUNG
S_OK
 Das Handle wurde erfolgreich zurückgegeben.
E_POINTER
 Der Wert von phandle ist ungültig. Es kann z. B. NULL sein.

Hinweise

Hinweise für Anrufer

Das Bildobjekt behält möglicherweise den Besitz des Bilds. Der Aufrufer kann jedoch sicher sein, dass das Bild gültig bleibt, bis entweder der Aufrufer das Bild explizit zerstört oder das Bildobjekt selbst zerstört wird. Der fOwn-Parameter für OleCreatePictureIndirect bestimmt den Besitz, wenn das Bildobjekt erstellt wird. OleLoadPicture erzwingt fOwn auf TRUE.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

Ipicture