MesEncodeFixedBufferHandleCreate-Funktion (midles.h)

Artikel
02/29/2024

Die MesEncodeFixedBufferHandleCreate-Funktion erstellt ein Codierungshandle und initialisiert es dann für einen festen Pufferstil der Serialisierung.

Syntax

RPC_STATUS MesEncodeFixedBufferHandleCreate(
  char          *pBuffer,
  unsigned long BufferSize,
  unsigned long *pEncodedSize,
  handle_t      *pHandle
);

Parameter

pBuffer

Zeiger auf den vom Benutzer bereitgestellten Puffer.

BufferSize

Größe des vom Benutzer bereitgestellten Puffers in Bytes.

pEncodedSize

Zeiger auf die Größe der abgeschlossenen Codierung. Die Größe wird von den nachfolgenden Codierungsvorgängen in den Zeiger geschrieben.

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 MesEncodeFixedBufferHandleCreate-Routine wird von Anwendungen verwendet, um den Handle für den festen Pufferstil der Codierung zu erstellen und zu initialisieren. Bei Verwendung des festen Pufferstils der Codierung stellt der Benutzer einen einzelnen Puffer bereit, in dem alle codierten Daten platziert werden. Dieser Puffer muss über eine Adresse verfügen, die auf 8 ausgerichtet ist, und ein Vielfaches von 8 Bytes groß sein. Darüber hinaus muss es groß genug sein, um eine Codierung aller Daten zusammen mit einem Codierungsheader für jede zu codierende Routine zu enthalten.

Wenn das Handle für mehrere Codierungsvorgänge verwendet wird, ist die codierte Größe kumulativ.

Wenn ein Stub mit -protocol all oder -protocol ndr64 kompiliert wird und der Puffer mithilfe der NDR64-Übertragungssyntax codiert werden soll, muss die MesBufferHandleReset-Funktion aufgerufen werden, wobei ihr 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

MesBufferhandleReset

MesDecodeBufferHandleCreate

MesHandleFree

Freigeben über