.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH ScRelocProps 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBScRelocProps\fR (MAPI32.172)
.SH SYNOPSIS
SCODE ScRelocProps
 (
  int          \fIcValues\fR,
  LPSPropValue \fIlpProps\fR,
  LPVOID       \fIlpOld\fR,
  LPVOID       \fIlpNew\fR,
  ULONG*       \fIlpCount\fR
 )

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

.SH PARAMS
\fIcValues\fR \fB[In]\fR  Number of properties in \fIlpProps\fR.
.PP
\fIlpProps\fR \fB[Out]\fR  Property array to relocate the pointers in.
.PP
\fIlpOld\fR \fB[In]\fR  Position where the data was copied from.
.PP
\fIlpNew\fR \fB[In]\fR  Position where the data was copied to.
.PP
\fIlpCount\fR \fB[Out]\fR  If non-NULL, destination for the number of bytes of data at lpDst.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR \fBS_OK\fR. Any pointers in \fIlpProps\fR are relocated. 
.PP
\fBFailure:\fR \fBMAPI_E_INVALID_PARAMETER\fR, if any parameter is invalid. 

.SH NOTES
.PP
\fBMSDN\fR states that this function can be used for serialisation by passing \fBNULL\fR as either \fIlpOld\fR or \fIlpNew\fR, thus converting any pointers in \fIlpProps\fR 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 \fBmemcpy(3w)\fR to another memory location. 

.SH IMPLEMENTATION
.PP
Declared in \fB"mapiutil.h"\fR. 
.PP
Implemented in \fB"dlls/mapi32/prop.c"\fR. 
.PP
Debug channel \fB"mapi"\fR.