IOleUIObjInfoW::GetObjectInfo-Methode (oledlg.h)

Artikel
03/01/2024

Ruft die Informationen zu Größe, Typ, Name und Speicherort für ein Objekt ab.

Syntax

HRESULT GetObjectInfo(
  [in]            DWORD  dwObject,
  [out]           DWORD  *lpdwObjSize,
  [out, optional] LPWSTR *lplpszLabel,
  [out, optional] LPWSTR *lplpszType,
  [out, optional] LPWSTR *lplpszShortType,
  [out, optional] LPWSTR *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 ist möglicherweise NULL , 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 Zeigervariablen, 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 ist möglicherweise NULL , 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 Allgemeine Objekteigenschaften angezeigt.

Hinweise für Implementierer

Ihre Implementierung von GetObjectInfo sollte jedes Der Attribute des Objekts in den bereitgestellten Out-Parametern platzieren. Legen Sie lpdwObjSize auf (DWORD)-1 fest, wenn die Größe des Objekts unbekannt ist. Ordnen Sie alle Zeichenfolgen (die restlichen Parameter) mit der ÜBER CoGetMalloc abgerufenen OLE-Aufgabenzuweisung zu, wie dies standardmäßig für alle OLE-Schnittstellen mit [out]-Zeichenfolgenparametern 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