Metodo IOleUIObjInfoW::GetObjectInfo (oledlg.h)

Articolo
03/05/2024

Ottiene le dimensioni, il tipo, il nome e le informazioni sulla posizione per un oggetto.

Sintassi

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

Parametri

[in] dwObject

Identificatore univoco per l'oggetto.

[out] lpdwObjSize

Puntatore alle dimensioni dell'oggetto, in byte, su disco. Questo può essere un valore approssimativo.

[out, optional] lplpszLabel

Indirizzo di una variabile puntatore che riceve un puntatore alla stringa di etichetta dell'oggetto. Questo parametro può essere NULL per indicare che l'implementazione non deve restituire la stringa di etichetta.

[out, optional] lplpszType

Indirizzo di una variabile puntatore che riceve un puntatore alla stringa di tipo lungo dell'oggetto. Questo parametro può essere NULL per indicare che l'implementazione non deve restituire la stringa di tipo lungo.

[out, optional] lplpszShortType

Indirizzo di una variabile puntatore che riceve un puntatore alla stringa di tipo breve dell'oggetto. Questo parametro può essere NULL per indicare che l'implementazione non deve restituire la stringa di tipo breve.

[out, optional] lplpszLocation

Indirizzo di una variabile puntatore che riceve un puntatore alla stringa di posizione di origine dell'oggetto. Questo parametro può essere NULL per indicare che l'implementazione non deve restituire la stringa di posizione.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_FAIL	Operazione non riuscita.
E_INVALIDARG	L'identificatore specificato non è valido.
E_OUTOFMEMORY	Per questa operazione è disponibile memoria insufficiente.

Commenti

Le stringhe e le dimensioni dell'oggetto vengono visualizzate nella pagina Generale delle proprietà dell'oggetto.

Note per gli implementatori

L'implementazione di GetObjectInfo deve inserire ognuno degli attributi dell'oggetto nei parametri out forniti. Impostare lpdwObjSize su (DWORD)-1 quando le dimensioni dell'oggetto sono sconosciute. Allocare tutte le stringhe (il resto dei params) con l'allocatore dell'attività OLE ottenuto tramite CoGetMalloc, come standard per tutte le interfacce OLE con parametri stringa [out] oppure è sufficiente usare CoTaskMemAlloc.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oledlg.h

Vedi anche

CoGetMalloc

Cotaskmemalloc

IOleUIObjInfo

Condividi tramite