Fonction MesBufferHandleReset (midles.h)

Article
08/24/2023

La fonction MesBufferHandleReset réinitialise le handle pour la sérialisation de la mémoire tampon.

Syntaxe

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

Paramètres

Handle

Handle à initialiser.

HandleStyle

Style de Handle. Les styles valides sont MES_FIXED_BUFFER_HANDLE ou MES_DYNAMIC_BUFFER_HANDLE.

Operation

Code d’opération. Les codes valides sont MES_ENCODE, MES_ENCODE_NDR64 ou MES_DECODE.

pBuffer

Pour MES_DECODE, pointez vers un pointeur vers la mémoire tampon contenant les données à décoder.

Par MES_ENCODE, pointez vers un pointeur vers la mémoire tampon pour le style de mémoire tampon fixe et pointez vers un pointeur pour retourner l’adresse de mémoire tampon pour le style de mémoire tampon dynamique de sérialisation.

Par MES_ENCODE_NDR64, pointeur vers un pointeur vers la mémoire tampon pour le style de mémoire tampon fixe et pointeur vers un pointeur pour retourner l’adresse de mémoire tampon pour le style de mémoire tampon dynamique de sérialisation, mais utilise explicitement NDR64 pour encoder la mémoire tampon. La mémoire tampon fournie par l’utilisateur doit être alignée sur 16.

BufferSize

Octets de données à décoder dans la mémoire tampon. Notez qu’il est utilisé uniquement pour le style de mémoire tampon fixe de sérialisation.

pEncodedSize

Pointeur vers la taille de l’encodage terminé. Notez qu’il est utilisé uniquement lorsque l’opération est MES_ENCODE ou MES_ENCODE_NDR64.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_ARG	L'argument n'était pas valide.

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

Notes

La routine MesBufferHandleReset est utilisée par les applications pour réinitialiser un handle de style de mémoire tampon et enregistrer les allocations de mémoire.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	midles.h (inclure Rpc.h)
Bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll

Voir aussi

MesEncodeDynBufferHandleCreate

MesEncodeFixedBufferHandleCreate

MesHandleFree

Partager via