NdrConformantStringUnmarshall-Funktion (rpcndr.h)

  • Artikel

Die NdrConformantStringUnmarshall-Funktion entmarshaliert die konforme Zeichenfolge aus dem Netzwerkpuffer in den Arbeitsspeicher.

Syntax

unsigned char * NdrConformantStringUnmarshall(
  [in, out] PMIDL_STUB_MESSAGE pStubMsg,
  [out]     unsigned char      **ppMemory,
  [in]      PFORMAT_STRING     pFormat,
  [in]      unsigned char      fMustAlloc
);

Parameter

[in, out] pStubMsg

Zeiger auf eine MIDL_STUB_MESSAGE-Struktur, die die aktuelle status des RPC-Stubs verwaltet. Diese Struktur ist nur für die interne Verwendung vorgesehen und sollte nicht geändert werden.

[out] ppMemory

Adresse an einen Zeiger auf die nicht übereinstimmende Zeichenfolge. Wenn dieser Wert auf NULL festgelegt ist oder fMustAlloc auf TRUE festgelegt ist, ordnet der Stub den Arbeitsspeicher zu.

[in] pFormat

Zeiger auf die Formatzeichenfolgenbeschreibung.

[in] fMustAlloc

Flag, das angibt, ob der Stub den Arbeitsspeicher zuordnen muss, in den die konforme Zeichenfolge gemarshallt werden soll. Geben Sie TRUE an, wenn RPC ppMemory zuordnen muss.

Rückgabewert

Gibt bei Erfolg NULL zurück. Wenn ein Fehler auftritt, löst die Funktion einen der folgenden Ausnahmecodes aus.

Fehler BESCHREIBUNG
RPC_BAD_STUB_DATA oder RPC_X_INVALID_BOUND Das Netzwerk ist falsch.
RPC_S_OUT_OF_MEMORY Nicht genügend Arbeitsspeicher.
STATUS_ACCESS_VIOLATION Es ist eine Zugriffsverletzung aufgetreten.
RPC_S_INTERNAL_ERROR Fehler in RPC.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile rpcndr.h (rpc.h einschließen)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll