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
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
|
L'argument n'était pas valide. |
|
Mémoire insuffisante. |
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
| Condition requise | Valeur |
|---|---|
| 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 |