MesBufferHandleReset-Funktion (midles.h)

Artikel
08/24/2023

Die MesBufferHandleReset-Funktion initialisiert das Handle für die Pufferserialisierung neu.

Syntax

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

Parameter

Handle

Das zu initialisierende Handle.

HandleStyle

Stil des Handles. Gültige Stile sind MES_FIXED_BUFFER_HANDLE oder MES_DYNAMIC_BUFFER_HANDLE.

Operation

Vorgangscode. Gültige Codes sind MES_ENCODE, MES_ENCODE_NDR64 oder MES_DECODE.

pBuffer

Zeigen Sie für MES_DECODE auf einen Zeiger auf den Puffer, der die zu decodierten Daten enthält.

Zeigen Sie bei MES_ENCODE auf einen Zeiger auf den Puffer für einen festen Pufferstil und auf einen Zeiger, um die Pufferadresse für den dynamischen Pufferstil der Serialisierung zurückzugeben.

Für MES_ENCODE_NDR64 zeiger auf einen Zeiger auf den Puffer für einen festen Pufferstil und Zeiger auf einen Zeiger, um die Pufferadresse für den dynamischen Pufferstil der Serialisierung zurückzugeben, verwendet jedoch explizit NDR64 zum Codieren des Puffers. Der vom Benutzer bereitgestellte Puffer muss an 16 ausgerichtet werden.

BufferSize

Bytes von Daten, die im Puffer decodiert werden sollen. Beachten Sie, dass dies nur für den festen Pufferstil der Serialisierung verwendet wird.

pEncodedSize

Zeiger auf die Größe der abgeschlossenen Codierung. Beachten Sie, dass dies nur verwendet wird, wenn der Vorgang MES_ENCODE oder MES_ENCODE_NDR64 ist.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_ARG	Das Argument war ungültig.

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

Hinweise

Die MesBufferHandleReset-Routine wird von Anwendungen verwendet, um ein Handle im Pufferstil neu zu initialisieren und Speicherbelegungen zu speichern.

Anforderungen


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 (rpc.h einschließen)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

MesEncodeDynBufferHandleErstellen

MesEncodeFixedBufferHandleErstellen

MesHandleFree

Freigeben über