attributo midl_user_allocate

La funzione midl_user_allocate è una funzione che le applicazioni client e server forniscono per allocare memoria.

void __RPC_FAR * __RPC_API midl_user_allocate (size_t cBytes);

Parametri

cBytes

Specifica il numero di byte da allocare.

Commenti

Sia le applicazioni client che le applicazioni server devono implementare la funzione midl_user_allocate , a meno che non si stia compilando in modalità OSF-compatibility (/osf). Le applicazioni e gli stub generati chiamano midl_user_allocate quando si tratta di oggetti a cui fa riferimento i puntatori:

• L'applicazione server deve chiamare midl_user_allocate per allocare memoria per l'applicazione, ad esempio quando si crea un nuovo nodo.
• Lo stub del server chiama midl_user_allocate quando si annulla ilmarshaling dei dati puntati nello spazio indirizzi del server.
• Lo stub client chiama midl_user_allocate quando si annullano i dati dal server a cui fa riferimento un puntatore. Si noti che per i puntatori [in], [out]e [unique] il client chiama midl_user_allocate solo se il valore del puntatore [univoco] era NULL in input e cambia in un valore non NULL durante la chiamata. Se il puntatore [univoco] non è null nell'input, lo stub client scrive i dati associati nella memoria esistente.

Se midl_user_allocate non riesce a allocare memoria, deve restituire un puntatore NULL .

È consigliabile midl_user_allocate restituire un puntatore allineato a 8 byte.

Esempi

#include <windows.h>

void __RPC_FAR * __RPC_API midl_user_allocate(size_t cBytes) 
{ 
    return(malloc(cBytes)); 
}

Vedere anche

Allocare

Matrici

Matrici e puntatori

Attributi di matrice e Sized-Pointer

Pollici

midl_user_free

/Osf

Cambio

Ptr

Ref

Unico