type_UserUnmarshal関数
<型>_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 型を意味します。 この型は、[user_marshal] 属性と共に使用する場合は、MIDL コンパイラには不明です。変換できない場合もあります。 ワイヤ型名 (透過型の名前) は、関数プロトタイプでは使用されません。 ただし、ワイヤ タイプでは、OSF DCE で指定されたデータのワイヤ レイアウトが定義されていることに注意してください。
pFlags パラメーターは、符号なし長 フラグ フィールドへのポインターです。 フラグの上の単語には、浮動小数点、バイト順、および文字表現の OSF DCE で定義されている NDR データ表現フラグが含まれています。 下の単語には、COM チャネルで定義されているマーシャリング コンテキスト フラグが含まれています。 フィールド内のフラグの正確なレイアウトについては、「type_UserSize関数 で説明されています。
pBuffer パラメーターは、現在のバッファー ポインターです。 このポインターは、入力時にアラインされる場合と配置されない場合があります。 <型>_UserUnmarshal 関数は、バッファー ポインターを適切に配置し、データのマーシャリングを解除し、新しいバッファー位置 (アンマーシャリングされたオブジェクトの後の最初のバイトのアドレス) を返す必要があります。
pMyObj パラメーターは、ユーザー定義型オブジェクトへのポインターです。
異種環境では、NDR エンジンは、<型>_UserUnmarshal 関数を呼び出す前に必要なデータ変換を実行します。 NDR エンジンは、このユーザー データ型に指定されたワイヤ型の定義に従って、このデータ変換を実行します。 このフラグは、送信者のデータ表現を示します。
関連トピック
-
user_marshalとwire_marshal のマーシャリング規則を する