IOleUIObjInfoA::GetObjectInfo-Methode (oledlg.h)

Artikel
03/01/2024

Ruft die Größen-, Typ-, Namens- und Standortinformationen für ein Objekt ab.

Syntax

HRESULT GetObjectInfo(
  [in]            DWORD dwObject,
  [out]           DWORD *lpdwObjSize,
  [out, optional] LPSTR *lplpszLabel,
  [out, optional] LPSTR *lplpszType,
  [out, optional] LPSTR *lplpszShortType,
  [out, optional] LPSTR *lplpszLocation
);

Parameter

[in] dwObject

Eindeutiger Bezeichner des Objekts.

[out] lpdwObjSize

Zeiger auf die Größe des Objekts in Bytes auf dem Datenträger. Dies kann ein ungefährer Wert sein.

[out, optional] lplpszLabel

Adresse einer Zeigervariable, die einen Zeiger auf die Bezeichnungszeichenfolge des Objekts empfängt. Dieser Parameter kann NULL sein, um anzugeben, dass die Implementierung die Bezeichnungszeichenfolge nicht zurückgeben soll.

[out, optional] lplpszType

Adresse einer Zeigervariable, die einen Zeiger auf die lange Typzeichenfolge des Objekts empfängt. Dieser Parameter kann NULL sein, um anzugeben, dass die Implementierung die Zeichenfolge des langen Typs nicht zurückgeben soll.

[out, optional] lplpszShortType

Adresse einer Zeigervariable, die einen Zeiger auf die kurze Typzeichenfolge des Objekts empfängt. Dieser Parameter kann NULL sein, um anzugeben, dass die Implementierung die kurze Typzeichenfolge nicht zurückgeben soll.

[out, optional] lplpszLocation

Adresse einer Zeigervariable, die einen Zeiger auf die Quellspeicherortzeichenfolge des Objekts empfängt. Dieser Parameter kann NULL sein, um anzugeben, dass die Implementierung die Speicherortzeichenfolge nicht zurückgeben soll.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_FAIL	Fehler beim Vorgang.
E_INVALIDARG	Der angegebene Bezeichner ist ungültig.
E_OUTOFMEMORY	Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Die Zeichenfolgen und die Größe des Objekts werden auf der Seite "Objekteigenschaften Allgemein " angezeigt.

Hinweise zu Implementierern

Bei der Implementierung von GetObjectInfo sollten alle Attribute des Objekts in den angegebenen Out-Parametern platziert werden. Legen Sie lpdwObjSize auf (DWORD)-1 fest, wenn die Größe des Objekts unbekannt ist. Ordnen Sie alle Zeichenfolgen (die restlichen Params) mit dem über CoGetMalloc abgerufenen OLE-Aufgabenzuordnung zu, wie es für alle OLE-Schnittstellen mit [out]-Zeichenfolgenparametern standardisiert ist, oder Sie können einfach CoTaskMemAlloc verwenden.

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	oledlg.h

Weitere Informationen

CoGetMalloc

CoTaskMemAlloc

IOleUIObjInfo

Freigeben über