Funzione MesEncodeDynBufferHandleCreate (midles.h)

La funzione MesEncodeDynBufferHandleCreate crea un handle di codifica e quindi la inizializza per uno stile di buffer dinamico della serializzazione.

Sintassi

RPC_STATUS MesEncodeDynBufferHandleCreate(
  char          **pBuffer,
  unsigned long *pEncodedSize,
  handle_t      *pHandle
);

Parametri

pBuffer

Puntatore a un puntatore al buffer fornito dallo stub contenente la codifica al termine della serializzazione.

pEncodedSize

Puntatore alle dimensioni della codifica completata. Le dimensioni verranno scritte nella posizione di memoria a cui fa riferimento pEncodedSize dalle operazioni di codifica successive.

pHandle

Puntatore all'indirizzo in cui verrà scritto l'handle.

Valore restituito

Commenti

La routine MesEncodeDynBufferHandleCreate viene usata dalle applicazioni per allocare la memoria e inizializzare l'handle per lo stile di buffer dinamico della codifica. Quando si usa lo stile del buffer dinamico della codifica, il buffer in cui verranno inseriti tutti i dati codificati viene fornito dallo stub. Questo buffer verrà allocato dal meccanismo di gestione della memoria client corrente.

Possono verificarsi implicazioni per le prestazioni quando si usa questo stile per più codifiche con lo stesso handle. Un singolo buffer viene restituito da una codifica e i dati vengono copiati dai buffer intermedi. I buffer vengono rilasciati quando necessario.

Quando uno stub viene compilato usando -protocol all o -protocol ndr64 e il buffer deve essere codificato usando la sintassi di trasferimento NDR64, la funzione MesBufferHandleReset deve essere chiamata con il relativo parametro OpCode impostato su MES_ENCODE_NDR64.

Requisiti

Vedi anche

MesBufferhandleReset

MesHandleFree