Funzione MesBufferHandleReset (midles.h)

Articolo
08/24/2023

La funzione MesBufferHandleReset ri inizializza l'handle per la serializzazione del buffer.

Sintassi

RPC_STATUS MesBufferHandleReset(
  handle_t      Handle,
  unsigned long HandleStyle,
  MIDL_ES_CODE  Operation,
  char          **pBuffer,
  unsigned long BufferSize,
  unsigned long *pEncodedSize
);

Parametri

Handle

Handle da inizializzare.

HandleStyle

Stile di handle. Gli stili validi sono MES_FIXED_BUFFER_HANDLE o MES_DYNAMIC_BUFFER_HANDLE.

Operation

Codice operazione. I codici validi sono MES_ENCODE, MES_ENCODE_NDR64 o MES_DECODE.

pBuffer

Per MES_DECODE, puntatore a un puntatore al buffer contenente i dati da decodificare.

Per MES_ENCODE, puntatore a un puntatore al buffer per lo stile del buffer fisso e puntatore a un puntatore per restituire l'indirizzo del buffer per lo stile di serializzazione del buffer dinamico.

Per MES_ENCODE_NDR64, puntatore a un puntatore al buffer per lo stile del buffer fisso e puntatore a un puntatore per restituire l'indirizzo del buffer per lo stile di serializzazione del buffer dinamico, ma usa in modo esplicito NDR64 per codificare il buffer. Il buffer fornito dall'utente deve essere allineato a 16.

BufferSize

Byte di dati da decodificare nel buffer. Si noti che questa operazione viene usata solo per lo stile di serializzazione del buffer fisso.

pEncodedSize

Puntatore alle dimensioni della codifica completata. Si noti che questa operazione viene usata solo quando l'operazione è MES_ENCODE o MES_ENCODE_NDR64.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_ARG	L'argomento non è valido.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

La routine MesBufferHandleReset viene usata dalle applicazioni per inizializzare nuovamente un handle di stile del buffer e salvare le allocazioni di memoria.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	midles.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll

Vedi anche

MesEncodeDynBufferHandleCreate

MesEncodeFixedBufferHandleCreate

MesHandleFree

Condividi tramite