Función MesEncodeFixedBufferHandleCreate (midles.h)

  • Artículo

La función MesEncodeFixedBufferHandleCreate crea un identificador de codificación y, a continuación, lo inicializa para un estilo fijo de serialización de búfer.

Sintaxis

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

Parámetros

pBuffer

Puntero al búfer proporcionado por el usuario.

BufferSize

Tamaño del búfer proporcionado por el usuario, en bytes.

pEncodedSize

Puntero al tamaño de la codificación completada. El tamaño se escribirá en el puntero mediante las siguientes operaciones de codificación.

pHandle

Puntero al identificador recién creado.

Valor devuelto

Valor Significado
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_INVALID_ARG
 El argumento no era válido.
RPC_S_OUT_OF_MEMORY
 Memoria insuficiente
 
Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.
 

Comentarios

Las aplicaciones usan la rutina MesEncodeFixedBufferHandleCreate para crear e inicializar el identificador para el estilo fijo de búfer de codificación. Al usar el estilo fijo de búfer de codificación, el usuario proporciona un único búfer en el que se colocan todos los datos codificados. Este búfer debe tener una dirección que esté alineada en 8 y debe tener un tamaño de múltiplo de 8 bytes. Además, debe ser lo suficientemente grande como para contener una codificación de todos los datos, junto con un encabezado de codificación para cada rutina que se va a codificar.

Cuando el identificador se usa para varias operaciones de codificación, el tamaño codificado es acumulativo.

Cuando se compila un código auxiliar mediante -protocol all o -protocol ndr64 y el búfer se codifica mediante la sintaxis de transferencia NDR64, se debe llamar a la función MesBufferHandleReset con su parámetro OpCode establecido en MES_ENCODE_NDR64.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado midles.h (include Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

MesBufferhandleReset

MesDecodeBufferHandleCreate

MesHandleFree