Metodo IOleContainer::EnumObjects (oleidl.h)

Articolo
08/25/2023

Enumera gli oggetti nel contenitore corrente.

Sintassi

HRESULT EnumObjects(
  [in]  DWORD        grfFlags,
  [out] IEnumUnknown **ppenum
);

Parametri

[in] grfFlags

Specifica gli oggetti da enumerare in un contenitore, come definito nell'enumerazione OLECONTF.

[out] ppenum

Puntatore a una variabile puntatore IEnumUnknown che riceve il puntatore di interfaccia all'oggetto enumeratore. Ogni volta che un contenitore riceve una chiamata a EnumObjects, deve aumentare il conteggio dei riferimenti sul puntatore dpinum restituito dal metodo. È responsabilità del chiamante chiamare IUnknown::Release quando viene eseguita con il puntatore. Se viene restituito un errore, l'implementazione deve impostare ppenum su NULL.

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_NOTIMPL	Enumerazione oggetto non supportata.

Commenti

Un contenitore deve implementare EnumObjects per consentire ai client a livello di codice di individuare gli oggetti che contiene. Questo metodo, tuttavia, non viene chiamato negli scenari di collegamento standard.

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

Vedi anche

Share via