type_UserUnmarshal関数

<type>_UserUnmarshal 関数は、[ wire_marshal] 属性と [ user_marshal] 属性のヘルパー関数です。 スタブは、この関数を呼び出して、クライアント側またはサーバー側のデータのマーシャリングを解除します。 関数は次のように定義されます。

unsigned char __RPC_FAR * __RPC_USER  <type>_UserUnmarshal(
    unsigned long __RPC_FAR * pFlags,
    unsigned char __RPC_FAR * pBuffer,
    <type>  __RPC_FAR *       pMyObj);

関数名の型>は<、[wire_marshal] または [user_marshal] 型定義で指定された userm 型を意味します。 この型は、MIDL コンパイラでは不明な [ user_marshal] 属性と共に使用する場合でも、転送できない場合があります。 ワイヤ型名 (透過型の名前) は、関数プロトタイプでは使用されません。 ただし、ワイヤ タイプでは、OSF DCE で指定されたデータのワイヤ レイアウトが定義されていることに注意してください。

pFlags パラメーターは、署名されていない長いフラグ フィールドへのポインターです。 フラグの上位ワードには、浮動小数点、バイト順、および文字表現に対して OSF DCE によって定義される NDR データ表現フラグが含まれています。 下の単語には、COM チャネルで定義されているマーシャリング コンテキスト フラグが含まれています。 フィールド内のフラグの正確なレイアウトについては、「 type_UserSize関数」を参照してください。

pBuffer パラメーターは、現在のバッファー ポインターです。 このポインターは、入力時に配置される場合と配置されていない場合があります。 型<>_UserUnmarshal関数は、バッファー ポインターを適切に配置し、データのマーシャリングを解除し、新しいバッファー位置 (非マーシャリングされたオブジェクトの後の最初のバイトのアドレス) を返す必要があります。

pMyObj パラメーターは、ユーザー定義型オブジェクトへのポインターです。

異種環境では、NDR エンジンは型>_UserUnmarshal 関数を呼び出す前に必要なデータ変換を<実行します。 NDR エンジンは、このユーザー データ型に対して指定されたワイヤ型の定義に従って、このデータ変換を実行します。 フラグは、送信者のデータ表現を示します。

関連トピック

user_marshalとwire_marshalのマーシャリングルール

wire_marshal

user_marshal