Funzione OleCreateDefaultHandler (ole2.h)
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 |