Funzione CreateGenericComposite (objbase.h)

Esegue una composizione generica di due moniker e fornisce un puntatore al moniker composito risultante.

Sintassi

HRESULT CreateGenericComposite(
  [in, optional] LPMONIKER pmkFirst,
  [in, optional] LPMONIKER pmkRest,
  [out]          LPMONIKER *ppmkComposite
);

Parametri

[in, optional] pmkFirst

Puntatore al moniker da comporre a sinistra del moniker a cui punta pmkRest. Può puntare a qualsiasi tipo di moniker, incluso un composito generico.

[in, optional] pmkRest

Puntatore al moniker da comporre a destra del moniker a cui pmkFirst punta. Può puntare a qualsiasi tipo di moniker compatibile con il tipo di moniker pmkRest , incluso un composito generico.

[out] ppmkComposite

Indirizzo di una variabile puntatore IMoniker* che riceve il puntatore dell'interfaccia all'oggetto moniker composito che è il risultato della composizione di pmkFirst e pmkRest. Questo oggetto supporta l'implementazione del moniker composito OLE di IMoniker. In caso di esito positivo, la funzione ha chiamato AddRef nel moniker e il chiamante è responsabile della chiamata a Release. Se pmkFirst o pmkRest sono NULL, il puntatore fornito è quello non NULL. Se sia pmkFirst che pmkRest sono NULL o se si verifica un errore, il puntatore restituito è NULL.

Valore restituito

Questa funzione può restituire il valore restituito standard E_OUTOFMEMORY, nonché i valori seguenti.

Commenti

CreateGenericComposite aggiunge due moniker a uno. Le classi moniker aggiunte possono essere diverse, soggette solo alle regole di composizione. Chiamare questa funzione solo se si sta scrivendo una nuova classe moniker implementando l'interfaccia IMoniker , all'interno di un'implementazione di IMoniker::ComposeWith che include funzionalità di composizione generiche.

I provider moniker devono chiamare ComposeWith per comporre due moniker insieme. Le implementazioni di ComposeWith devono (come per le implementazioni OLE) tentare, quando ragionevole per la classe, di eseguire prima le composizioni non generiche, in cui vengono combinati due moniker della stessa classe. Se non è possibile, l'implementazione può chiamare CreateGenericComposite per eseguire una composizione generica, che combina due moniker di classi diverse, all'interno delle regole di composizione. È possibile definire nuovi tipi di composizioni non generiche se si scrive una nuova classe moniker.

Durante il processo di composizione dei due moniker, CreateGenericComposite rende tutte le possibili semplificazioni. Si consideri l'esempio in cui pmkFirst è il moniker composito generico, A + B + C e pmkRest è il moniker composito generico, C -1 + B -1 + Z (dove C -1 è l'inverso di C). La funzione compone prima C a C -1, che compone in nulla. Quindi compone B e B -1 per niente. Infine, compone A a Z e fornisce un puntatore al moniker composito generico, A + Z.

Requisiti

Vedi anche

Imoniker

IMoniker::ComposeWith