Metodo IOleUIObjInfoA::GetObjectInfo (oledlg.h)

Articolo
03/01/2024

Ottiene le informazioni relative a dimensioni, tipo, nome e posizione per un oggetto .

Sintassi

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

Parametri

[in] dwObject

Identificatore univoco per l'oggetto.

[out] lpdwObjSize

Puntatore alle dimensioni dell'oggetto, in byte, su disco. Può trattarsi di un valore approssimativo.

[out, optional] lplpszLabel

Indirizzo di una variabile del 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 long dell'oggetto. Questo parametro può essere NULL per indicare che l'implementazione non deve restituire la stringa di tipo long.

[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	Memoria insufficiente per questa operazione.

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 la dimensione dell'oggetto è sconosciuta. Allocare tutte le stringhe (il resto dei parametri) con l'allocatore dell'attività OLE ottenuto tramite CoGetMalloc, come standard per tutte le interfacce OLE con parametri stringa [out] oppure è possibile usare semplicemente 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