MesEncodeIncrementalHandleCreate-Funktion (midles.h)

Artikel
02/29/2024

Die MesEncodeIncrementalHandleCreate-Funktion erstellt eine Codierung und initialisiert sie dann für den inkrementellen Stil der Serialisierung.

Syntax

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

Parameter

UserState

Zeiger auf das vom Benutzer bereitgestellte Zustandsobjekt, das die vom Benutzer bereitgestellten Funktionen Alloc, Write und Read koordiniert.

AllocFn

Zeiger auf die vom Benutzer bereitgestellte Alloc-Funktion .

WriteFn

Zeiger auf die vom Benutzer bereitgestellte Schreibfunktion .

pHandle

Zeiger auf den neu erstellten Handle.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_ARG	Das Argument war ungültig.
RPC_S_OUT_OF_MEMORY	Nicht genügend Arbeitsspeicher.

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

Hinweise

Die MesEncodeIncrementalHandleCreate-Funktion wird von Anwendungen verwendet, um das Handle für den inkrementellen Stil der Codierung oder Decodierung zu erstellen und zu initialisieren. Bei Verwendung des inkrementellen Codierungsstils stellt der Benutzer eine Alloc-Funktion bereit, um einen leeren Puffer bereitzustellen, in den die codierten Daten platziert werden, und eine Schreibfunktion , die aufgerufen werden soll, wenn der Puffer voll ist oder die Codierung abgeschlossen ist. Weitere Informationen zu den vom Benutzer bereitgestellten Funktionen Alloc, Write und Read finden Sie unter Serialisierungsdienste.

Wenn ein Stub mit -protocol all oder -protocol ndr64 kompiliert wird und der Puffer mithilfe der NDR64-Übertragungssyntax codiert werden soll, muss die MesIncrementalHandleReset-Funktion aufgerufen werden, wobei der OpCode-Parameter auf MES_ENCODE_NDR64 festgelegt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	midles.h (include Rpc.h)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

Alloc

MesBufferHandleReset

MesHandleFree

MesIncrementalHandleReset

Freigeben über