Función MesEncodeDynBufferHandleCreate (midles.h)

  • Artículo

La función MesEncodeDynBufferHandleCreate crea un identificador de codificación y, a continuación, lo inicializa para un estilo de búfer dinámico de serialización.

Sintaxis

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

Parámetros

pBuffer

Puntero a un puntero al búfer proporcionado por código auxiliar que contiene la codificación una vez completada la serialización.

pEncodedSize

Puntero al tamaño de la codificación completada. El tamaño se escribirá en la ubicación de memoria a la que apunta pEncodedSize mediante las operaciones de codificación posteriores.

pHandle

Puntero a la dirección a la que se escribirá el identificador.

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, consulte Rpc Return Values.
 

Comentarios

Las aplicaciones usan la rutina MesEncodeDynBufferHandleCreate para asignar la memoria e inicializar el identificador para el estilo dinámico de búfer de codificación. Cuando se usa el estilo de búfer dinámico de codificación, el código auxiliar proporciona el búfer en el que se colocarán todos los datos codificados. El mecanismo actual de administración de memoria asignará este búfer.

Puede haber implicaciones de rendimiento al usar este estilo para varias codificaciones con el mismo identificador. Se devuelve un único búfer de una codificación y los datos se copian de los búferes intermedios. Los búferes se liberan cuando sea necesario.

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

   
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

MesHandleFree