NdrGetUserMarshalInfo-Funktion (rpcndr.h)

  • Artikel

Die Funktion NdrGetUserMarshalInfo stellt zusätzliche Informationen zum wire_marshal und user_marshal Hilfsfunktionen bereit.

Syntax

RPC_STATUS NdrGetUserMarshalInfo(
  unsigned long         *pFlags,
  unsigned long         InformationLevel,
  NDR_USER_MARSHAL_INFO *pMarshalInfo
);

Parameter

pFlags

Zeiger mit demselben Namen, den RPC an die Hilfsfunktion übergeben hat.

InformationLevel

Gewünschte Detailebene, die empfangen werden soll. Unterschiedliche Ebenen implizieren unterschiedliche Sätze von Informationsfeldern. Derzeit ist nur Ebene 1 definiert.

pMarshalInfo

Adresse eines Speicherpuffers, der von der Anwendung bereitgestellt wird, um die angeforderten Informationen zu empfangen. Der Puffer muss mindestens so groß sein wie die von InformationLevel angegebene Informationsstruktur.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_INVALID_ARG
 Mindestens eines der Argumente war ungültig.
RPC_X_INVALID_BUFFER
 Der aktuelle Marshallpuffer war ungültig.

Hinweise

Die NdrGetUserMarshalInfo-Funktion wird vom wire_marshal- oder user_marshal Hilfsfunktionen (von der Anwendung bereitgestellt) <typ>_UserSize, <type>_UserMarshal, <type>_UserUnmarshal und <type> aufgerufen_UserFree um zusätzliche Informationen zum Status des Aufrufs zu erhalten. Eine häufige Verwendung für diese Funktion besteht darin, die Größe des Marshallpuffers zu erhalten, um das Ende der Pufferbedingungen zu überprüfen. Das Senden falsch dimensionierter Daten ist eine häufig verwendete Methode zur Verletzung der Systemsicherheit.

Eine vollständige Auflistung der von NdrGetUserMarshalInfo zurückgegebenen Informationen finden Sie unter NDR_USER_MARSHAL_INFO.

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 (include Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

NDR_USER_MARSHAL_INFO

user_marshal

wire_marshal