Regole di gestione della memoria
La durata dei puntatori alle interfacce viene sempre gestita tramite i metodi AddRef e Release in ogni interfaccia COM. Per altre informazioni, vedere Regole per la gestione dei conteggi di riferimento.
Per tutti gli altri parametri, è importante rispettare determinate regole per la gestione della memoria. Le regole seguenti si applicano a tutti i parametri dei metodi di interfaccia, incluso il valore restituito non passato per valore:
- I parametri in ingresso devono essere allocati e liberati dal chiamante.
- I parametri out devono essere allocati da quello chiamato; vengono liberati dal chiamante usando l'allocatore di memoria dell'attività COM standard. Per altre informazioni, vedere Allocatore di memoria OLE.
- I parametri in/out vengono inizialmente allocati dal chiamante e quindi liberati e riallocati da quello chiamato, se necessario. Come è true per i parametri out, il chiamante è responsabile della liberazione del valore restituito finale. È necessario usare l'allocatore di memoria COM standard.
Negli ultimi due casi, in cui un frammento di codice alloca la memoria e un'altra parte di codice lo libera, l'uso dell'allocatore COM garantisce che le due parti di codice usino gli stessi metodi di allocazione.
Un'altra area che richiede particolare attenzione è il trattamento dei parametri out e out in condizioni di errore. Se una funzione restituisce un codice di errore, il chiamante in genere non ha modo di pulire i parametri out o in-out. Ciò comporta le regole aggiuntive seguenti:
- In caso di condizione di errore, i parametri devono essere sempre impostati in modo affidabile su un valore che verrà pulito senza alcuna azione da parte del chiamante.
- Tutti i parametri del puntatore devono essere impostati in modo esplicito su NULL. Questi vengono in genere passati in un parametro puntatore a puntatore, ma possono anche essere passati come membri di una struttura allocata dal chiamante e il cosiddetto riempimento del codice. Il modo più semplice per assicurarsi che questo sia (in parte) per impostare questi valori su NULL nella voce della funzione. Questa regola è importante perché promuove un'interoperabilità delle applicazioni più affidabile.
- In condizioni di errore, tutti i parametri in uscita devono essere lasciati da soli dal codice chiamato (pertanto rimanenti al valore a cui sono stati inizializzati dal chiamante) o essere impostati in modo esplicito, come nel caso restituito dell'errore del parametro out.
Tenere presente che queste convenzioni di gestione della memoria per le applicazioni COM si applicano solo tra interfacce pubbliche e API; Non è necessario che l'allocazione di memoria sia strettamente interna a un'applicazione COM usando questi meccanismi.
COM usa internamente chiamate rpc (Remote Procedure Call) per comunicare tra client e server. Per altre informazioni sulla gestione della memoria negli stub del server RPC, vedere l'argomento Server-stub Memory Management .