Fonction MesEncodeIncrementalHandleCreate (midles.h)

La fonction MesEncodeIncrementalHandleCreate crée un encodage, puis l’initialise pour le style incrémentiel de sérialisation.

Syntaxe

RPC_STATUS MesEncodeIncrementalHandleCreate(
  void          *UserState,
  MIDL_ES_ALLOC AllocFn,
  MIDL_ES_WRITE WriteFn,
  handle_t      *pHandle
);

Paramètres

UserState

Pointeur vers l’objet d’état fourni par l’utilisateur qui coordonne les fonctions Alloc, Write et Read fournies par l’utilisateur.

AllocFn

Pointeur vers la fonction Alloc fournie par l’utilisateur.

WriteFn

Pointeur vers la fonction Write fournie par l’utilisateur.

pHandle

Pointeur vers le handle nouvellement créé.

Valeur retournée

Remarques

La fonction MesEncodeIncrementalHandleCreate est utilisée par les applications pour créer et initialiser le handle pour le style incrémentiel d’encodage ou de décodage. Lors de l’utilisation du style d’encodage incrémentiel, l’utilisateur fournit une fonction Alloc pour fournir une mémoire tampon vide dans laquelle les données encodées sont placées, et une fonction d’écriture à appeler lorsque la mémoire tampon est pleine ou que l’encodage est terminé. Pour plus d’informations sur les fonctions Alloc, Write et Read fournies par l’utilisateur, consultez Serialization Services.

Lorsqu’un stub est compilé à l’aide de -protocol all ou -protocol ndr64 et que la mémoire tampon doit être encodée à l’aide de la syntaxe de transfert NDR64, la fonction MesIncrementalHandleReset doit être appelée avec son paramètre OpCode défini sur MES_ENCODE_NDR64.

Configuration requise

Voir aussi

Alloc

MesBufferHandleReset

MesHandleFree

MesIncrementalHandleReset