Funzione OleRegEnumVerbs (ole2.h)

Articolo
08/25/2023

Fornisce un'enumerazione dei verbi registrati per la classe specificata. Gli sviluppatori di applicazioni oggetti DLL personalizzate usano questa funzione per emulare il comportamento del gestore oggetti predefinito.

Sintassi

HRESULT OleRegEnumVerbs(
  [in]  REFCLSID      clsid,
  [out] LPENUMOLEVERB *ppenum
);

Parametri

[in] clsid

Identificatore di classe i cui verbi vengono richiesti.

[out] ppenum

Indirizzo della variabile puntatore IEnumOLEVERB* che riceve il puntatore di interfaccia al nuovo oggetto di enumerazione.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Codice restituito	Descrizione
OLEOBJ_E_NOVERBS	Nessun verbo viene registrato per la classe .
REGDB_E_CLASSNOTREG	Nessun CLSID è registrato per l'oggetto classe.
REGDB_E_READREGDB	Errore durante la lettura del Registro di sistema.
OLE_E_REGDB_KEY	La chiave DataFormats/GetSet non è presente nel Registro di sistema.

Commenti

Le applicazioni oggetto possono chiedere a OLE di creare un oggetto di enumerazione per le strutture OLEVERB per enumerare i verbi supportati in uno dei due modi. Un modo consiste nel chiamare OleRegEnumVerbs. L'altro modo consiste nel restituire OLE_S_USEREG in risposta alle chiamate dal gestore di oggetti predefinito a IOleObject::EnumVerbs. OLE_S_USEREG indica al gestore predefinito di chiamare OleRegEnumVerbs. Poiché le applicazioni oggetto DLL non possono restituire OLE_S_USEREG, devono chiamare OleRegEnumVerbs anziché delegare il processo al gestore oggetti. Con il puntatore IEnumOLEVERB fornito all'oggetto, è possibile chiamare i metodi dell'oggetto di enumerazione standard per eseguire l'enumerazione .

La funzione OleRegEnumVerbs e le relative funzioni di pari livello , OleRegGetUserType, OleRegGetMiscStatus e OleRegEnumFormatEtc consentono agli sviluppatori di applicazioni di oggetti DLL personalizzate di emulare il comportamento del gestore oggetti predefinito di OLE per ottenere informazioni sugli oggetti dal Registro di sistema. Usando queste funzioni, si evitano le notevoli operazioni di scrittura personalizzate e le insidie intrinseche nel lavorare direttamente nel Registro di sistema. Inoltre, si ottengono miglioramenti e ottimizzazioni futuri di queste funzioni senza dover codificarli manualmente.

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	ole2.h
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-3 (introdotto in Windows 10, versione 10.0.10240)

Vedi anche

IEnumOLEVERB

IOleObject::EnumVerbs

Condividi tramite