Riepilogo delle regole di allocazione della memoria

La tabella seguente riepiloga le regole chiave relative all'allocazione di memoria.

Elemento MIDL	Descrizione
Puntatori di primo livello [ ref]	Deve essere puntatore non Null.
Valore restituito della funzione	La nuova memoria viene sempre allocata per i valori restituiti del puntatore.
[ unique, out] o [ ptr, out] puntatore	Non consentito da MIDL.
Puntatore non di primo livello [unique, in, out] o [ptr, in, out] che passa da Null a non Null	Gli stub client allocano nuova memoria al client al ritorno.
Puntatore non di primo livello [univoco, in, out] che passa da non Null a Null	La memoria è orfana nel client; l'applicazione client è responsabile della liberazione della memoria e della prevenzione delle perdite.
Puntatore non di primo livello [ptr, in, out] che passa da non Null a Null	La memoria verrà orfana nel client se non viene eseguito l'alias; l'applicazione client è responsabile della liberazione e della prevenzione delle perdite di memoria in questo caso.
[ref] puntatori	Il livello applicazione client viene in genere allocato.
Puntatore non null [in, out]	Gli stub tentano di scrivere nell'archiviazione esistente nel client. Se [string] e le dimensioni aumentano oltre le dimensioni allocate nel client, genererà un errore criteri di gruppo al ritorno.

 

Nella tabella seguente vengono riepilogati gli effetti degli attributi IDL e ACF principali sulla gestione della memoria.

Funzionalità MIDL	Problemi relativi al client	Problemi del server
[ allocate(single_node)], [allocate(all_nodes)]	Determina se vengono effettuate una o più chiamate alle funzioni di memoria.	Analogamente al client, ad eccezione della memoria privata, spesso può essere usata per allocare (single_node) [in] e [in,out] i dati.
[allocate(free)] o [allocate(dont_free)]	(Nessuno; influisce sul server).	Determina se la memoria nel server viene liberata dopo ogni chiamata di procedura remota.
attributi di matrice [ max_is] e [ size_is]	(Nessuno; influisce sul server).	Determina le dimensioni della memoria da allocare.
[ byte_count]	Il client deve allocare buffer; non allocata o liberata dagli stub del client.	L'attributo del parametro ACF determina le dimensioni del buffer allocato nel server.
[ enable_allocate]	Di solito, nessuno. Tuttavia, il client può usare un ambiente di gestione della memoria diverso.	Il server usa un ambiente di gestione della memoria diverso. RpcSmAllocate deve essere usato per le allocazioni.
[ in]attributo	Applicazione client responsabile dell'allocazione della memoria per i dati.	Allocato nel server da stub.
Attributo [ out]	Allocato nel client da stub.	[out]-only puntatore deve essere [ref] puntatore; allocato nel server da stub.
Attributo [ ref]	La memoria a cui fa riferimento il puntatore deve essere allocata dall'applicazione client.	Puntatori di riferimento di primo livello e di primo livello gestiti da stub.
Attributo [ unique]	Il valore da non Null a Null può comportare la memoria orfana; Null a non Null fa sì che lo stub del client chiami midl_user_allocate.	(Influisce sul client.
Attributo [ ptr]	(Vedere [ unique].)	(Vedere [ unique].)