Wine API: ScRelocProps

NAME

ScRelocProps (MAPI32.172)

SYNOPSIS

 SCODE ScRelocProps
 (
  int          cValues,
  LPSPropValue lpProps,
  LPVOID       lpOld,
  LPVOID       lpNew,
  ULONG*       lpCount
 )

DESCRIPTION

Relocate the pointers in an array of property values after it has been copied.

PARAMS

`cValues`	[In]	Number of properties in `lpProps`.
`lpProps`	[Out]	Property array to relocate the pointers in.
`lpOld`	[In]	Position where the data was copied from.
`lpNew`	[In]	Position where the data was copied to.
`lpCount`	[Out]	If non-NULL, destination for the number of bytes of data at lpDst.

RETURNS

Success: S_OK. Any pointers in lpProps are relocated.

Failure: MAPI_E_INVALID_PARAMETER, if any parameter is invalid.

NOTES

MSDN states that this function can be used for serialisation by passing NULL as either lpOld or lpNew, thus converting any pointers in lpProps between offsets and pointers. This does not work in native (it crashes), and cannot be made to work in Wine because the original interface design is deficient. The only use left for this function is to remap pointers in a contiguous property array that has been copied with memcpy to another memory location.

IMPLEMENTATION

Declared in "include/mapiutil.h". gitlab.winehq.org/wine/wine/blob/master/include/mapiutil.h

Implemented in "dlls/mapi32/prop.c". gitlab.winehq.org/wine/wine/blob/master/dlls/mapi32/prop.c

Debug channel "mapi".