Funzione MesEncodeFixedBufferHandleCreate (midles.h)

La funzione MesEncodeFixedBufferHandleCreate crea un handle di codifica e la inizializza per uno stile di serializzazione del buffer fisso.

Sintassi

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

Parametri

pBuffer

Puntatore al buffer fornito dall'utente.

BufferSize

Dimensioni del buffer fornito dall'utente, in byte.

pEncodedSize

Puntatore alle dimensioni della codifica completata. Le dimensioni verranno scritte nel puntatore dalle operazioni di codifica successive.

pHandle

Puntatore all'handle appena creato.

Valore restituito

Commenti

La routine MesEncodeFixedBufferHandleCreate viene usata dalle applicazioni per creare e inizializzare l'handle per lo stile predefinito del buffer di codifica. Quando si usa lo stile di codifica del buffer fisso, l'utente fornisce un singolo buffer in cui vengono inseriti tutti i dati codificati. Questo buffer deve avere un indirizzo allineato a 8 e deve essere un multiplo di 8 byte di dimensioni. Inoltre, deve contenere una codifica sufficiente per contenere una codifica di tutti i dati, insieme a un'intestazione di codifica per ogni routine codificata.

Quando l'handle viene usato per più operazioni di codifica, la dimensione codificata è cumulativa.

Quando viene compilato uno stub 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

MesDecodeBufferHandleCreate

MesHandleFree