IOleUIObjInfoA::GetObjectInfo-Methode (oledlg.h)

  • Artikel

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