Funzione OleCreateDefaultHandler (ole2.h)

Articolo
03/05/2024

Crea una nuova istanza del gestore di incorporamento predefinito. Questa istanza viene inizializzata in modo che crei un server locale quando l'oggetto incorporato entra nello stato di esecuzione.

Sintassi

HRESULT OleCreateDefaultHandler(
  [in]  REFCLSID  clsid,
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFIID    riid,
  [out] LPVOID    *lplpObj
);

Parametri

[in] clsid

CLSID che identifica il server OLE da caricare quando l'oggetto incorporato entra nello stato di esecuzione.

[in] pUnkOuter

Puntatore all'interfaccia IUnknown di controllo se il gestore deve essere aggregato; NULL se non deve essere aggregato.

[in] riid

Riferimento all'identificatore dell'interfaccia, in genere IID_IOleObject, tramite cui il chiamante comunicherà con il gestore.

[out] lplpObj

Indirizzo della variabile del puntatore che riceve il puntatore di interfaccia richiesto in riid. Al termine della restituzione, *ppvObj contiene il puntatore di interfaccia richiesto nel gestore appena creato.

Valore restituito

Questa funzione restituisce NOERROR in caso di esito positivo e supporta il valore restituito standard E_OUTOFMEMORY.

Commenti

OleCreateDefaultHandler crea una nuova istanza del gestore di incorporamento predefinito, inizializzata in modo che crei un server locale identificato dal parametro clsid quando l'oggetto incorporato entra nello stato di esecuzione. Se si scrive un gestore e si desidera utilizzare i servizi del gestore predefinito, chiamare OleCreateDefaultHandler. OLE lo chiama internamente anche quando il CLSID specificato in una chiamata di creazione di oggetti non è registrato.

Se la classe specificata non dispone di un gestore speciale, una chiamata a OleCreateDefaultHandler produce gli stessi risultati di una chiamata alla funzione CoCreateInstance con il parametro di contesto della classe assegnato il valore CLSCTX_INPROC_HANDLER.

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

Vedi anche

CLSCTX

Cocreateinstance

Condividi tramite