msi: Callers of alloc_msihandle should handle failure.
[wine/multimedia.git] / dlls / msi / suminfo.c
blob7b547521d58bfd2be7bbc82acfe468500f8c041b
1 /*
2 * Implementation of the Microsoft Installer (msi.dll)
4 * Copyright 2002, 2005 Mike McCormack for CodeWeavers
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
21 #include <stdarg.h>
23 #define COBJMACROS
24 #define NONAMELESSUNION
26 #include "windef.h"
27 #include "winbase.h"
28 #include "winreg.h"
29 #include "winnls.h"
30 #include "shlwapi.h"
31 #include "wine/debug.h"
32 #include "msi.h"
33 #include "msiquery.h"
34 #include "msidefs.h"
35 #include "msipriv.h"
36 #include "objidl.h"
38 WINE_DEFAULT_DEBUG_CHANNEL(msi);
40 #include "pshpack1.h"
42 typedef struct {
43 WORD wByteOrder;
44 WORD wFormat;
45 DWORD dwOSVer;
46 CLSID clsID;
47 DWORD reserved;
48 } PROPERTYSETHEADER;
50 typedef struct {
51 FMTID fmtid;
52 DWORD dwOffset;
53 } FORMATIDOFFSET;
55 typedef struct {
56 DWORD cbSection;
57 DWORD cProperties;
58 } PROPERTYSECTIONHEADER;
60 typedef struct {
61 DWORD propid;
62 DWORD dwOffset;
63 } PROPERTYIDOFFSET;
65 typedef struct {
66 DWORD type;
67 union {
68 INT i4;
69 SHORT i2;
70 FILETIME ft;
71 struct {
72 DWORD len;
73 BYTE str[1];
74 } str;
75 } u;
76 } PROPERTY_DATA;
78 #include "poppack.h"
80 #define SECT_HDR_SIZE (sizeof(PROPERTYSECTIONHEADER))
82 static const WCHAR szSumInfo[] = { 5 ,'S','u','m','m','a','r','y',
83 'I','n','f','o','r','m','a','t','i','o','n',0 };
85 static void free_prop( PROPVARIANT *prop )
87 if (prop->vt == VT_LPSTR )
88 msi_free( prop->u.pszVal );
89 prop->vt = VT_EMPTY;
92 static void MSI_CloseSummaryInfo( MSIOBJECTHDR *arg )
94 MSISUMMARYINFO *si = (MSISUMMARYINFO *) arg;
95 DWORD i;
97 for( i = 0; i < MSI_MAX_PROPS; i++ )
98 free_prop( &si->property[i] );
99 msiobj_release( &si->db->hdr );
102 static UINT get_type( UINT uiProperty )
104 switch( uiProperty )
106 case PID_CODEPAGE:
107 return VT_I2;
109 case PID_SUBJECT:
110 case PID_AUTHOR:
111 case PID_KEYWORDS:
112 case PID_COMMENTS:
113 case PID_TEMPLATE:
114 case PID_LASTAUTHOR:
115 case PID_REVNUMBER:
116 case PID_APPNAME:
117 case PID_TITLE:
118 return VT_LPSTR;
120 case PID_LASTPRINTED:
121 case PID_CREATE_DTM:
122 case PID_LASTSAVE_DTM:
123 return VT_FILETIME;
125 case PID_WORDCOUNT:
126 case PID_CHARCOUNT:
127 case PID_SECURITY:
128 case PID_PAGECOUNT:
129 return VT_I4;
131 return VT_EMPTY;
134 static UINT get_property_count( PROPVARIANT *property )
136 UINT i, n = 0;
138 if( !property )
139 return n;
140 for( i = 0; i < MSI_MAX_PROPS; i++ )
141 if( property[i].vt != VT_EMPTY )
142 n++;
143 return n;
146 /* FIXME: doesn't deal with endian conversion */
147 static void read_properties_from_data( PROPVARIANT *prop, LPBYTE data, DWORD sz )
149 UINT type;
150 DWORD i;
151 int size;
152 PROPERTY_DATA *propdata;
153 PROPVARIANT *property;
154 PROPERTYIDOFFSET *idofs;
155 PROPERTYSECTIONHEADER *section_hdr;
157 section_hdr = (PROPERTYSECTIONHEADER*) &data[0];
158 idofs = (PROPERTYIDOFFSET*) &data[SECT_HDR_SIZE];
160 /* now set all the properties */
161 for( i = 0; i < section_hdr->cProperties; i++ )
163 type = get_type( idofs[i].propid );
164 if( type == VT_EMPTY )
166 ERR("propid %ld has unknown type\n", idofs[i].propid);
167 break;
170 propdata = (PROPERTY_DATA*) &data[ idofs[i].dwOffset ];
172 /* check the type is the same as we expect */
173 if( type != propdata->type )
175 ERR("wrong type %d != %ld\n", type, propdata->type);
176 break;
179 /* check we don't run off the end of the data */
180 size = sz - idofs[i].dwOffset - sizeof(DWORD);
181 if( sizeof(DWORD) > size ||
182 ( type == VT_FILETIME && sizeof(FILETIME) > size ) ||
183 ( type == VT_LPSTR && (propdata->u.str.len + sizeof(DWORD)) > size ) )
185 ERR("not enough data\n");
186 break;
189 if( idofs[i].propid >= MSI_MAX_PROPS )
191 ERR("Unknown property ID %ld\n", idofs[i].propid );
192 break;
195 property = &prop[ idofs[i].propid ];
196 property->vt = type;
198 if( type == VT_LPSTR )
200 LPSTR str = msi_alloc( propdata->u.str.len );
201 memcpy( str, propdata->u.str.str, propdata->u.str.len );
202 str[ propdata->u.str.len - 1 ] = 0;
203 property->u.pszVal = str;
205 else if( type == VT_FILETIME )
206 property->u.filetime = propdata->u.ft;
207 else if( type == VT_I2 )
208 property->u.iVal = propdata->u.i2;
209 else if( type == VT_I4 )
210 property->u.lVal = propdata->u.i4;
214 static UINT load_summary_info( MSISUMMARYINFO *si, IStream *stm )
216 UINT ret = ERROR_FUNCTION_FAILED;
217 PROPERTYSETHEADER set_hdr;
218 FORMATIDOFFSET format_hdr;
219 PROPERTYSECTIONHEADER section_hdr;
220 LPBYTE data = NULL;
221 LARGE_INTEGER ofs;
222 ULONG count, sz;
223 HRESULT r;
225 TRACE("%p %p\n", si, stm);
227 /* read the header */
228 sz = sizeof set_hdr;
229 r = IStream_Read( stm, &set_hdr, sz, &count );
230 if( FAILED(r) || count != sz )
231 return ret;
233 if( set_hdr.wByteOrder != 0xfffe )
235 ERR("property set not big-endian %04X\n", set_hdr.wByteOrder);
236 return ret;
239 sz = sizeof format_hdr;
240 r = IStream_Read( stm, &format_hdr, sz, &count );
241 if( FAILED(r) || count != sz )
242 return ret;
244 /* check the format id is correct */
245 if( !IsEqualGUID( &FMTID_SummaryInformation, &format_hdr.fmtid ) )
246 return ret;
248 /* seek to the location of the section */
249 ofs.QuadPart = format_hdr.dwOffset;
250 r = IStream_Seek( stm, ofs, STREAM_SEEK_SET, NULL );
251 if( FAILED(r) )
252 return ret;
254 /* read the section itself */
255 sz = SECT_HDR_SIZE;
256 r = IStream_Read( stm, &section_hdr, sz, &count );
257 if( FAILED(r) || count != sz )
258 return ret;
260 if( section_hdr.cProperties > MSI_MAX_PROPS )
262 ERR("too many properties %ld\n", section_hdr.cProperties);
263 return ret;
266 data = msi_alloc( section_hdr.cbSection);
267 if( !data )
268 return ret;
270 memcpy( data, &section_hdr, SECT_HDR_SIZE );
272 /* read all the data in one go */
273 sz = section_hdr.cbSection - SECT_HDR_SIZE;
274 r = IStream_Read( stm, &data[ SECT_HDR_SIZE ], sz, &count );
275 if( SUCCEEDED(r) && count == sz )
276 read_properties_from_data( si->property, data, sz + SECT_HDR_SIZE );
277 else
278 ERR("failed to read properties %ld %ld\n", count, sz);
280 msi_free( data );
281 return ret;
284 static DWORD write_dword( LPBYTE data, DWORD ofs, DWORD val )
286 if( data )
288 data[ofs++] = val&0xff;
289 data[ofs++] = (val>>8)&0xff;
290 data[ofs++] = (val>>16)&0xff;
291 data[ofs++] = (val>>24)&0xff;
293 return 4;
296 static DWORD write_filetime( LPBYTE data, DWORD ofs, LPFILETIME ft )
298 write_dword( data, ofs, ft->dwLowDateTime );
299 write_dword( data, ofs + 4, ft->dwHighDateTime );
300 return 8;
303 static DWORD write_string( LPBYTE data, DWORD ofs, LPCSTR str )
305 DWORD len = lstrlenA( str ) + 1;
306 write_dword( data, ofs, len );
307 if( data )
308 memcpy( &data[ofs + 4], str, len );
309 return (7 + len) & ~3;
312 static UINT write_property_to_data( PROPVARIANT *prop, LPBYTE data )
314 DWORD sz = 0;
316 if( prop->vt == VT_EMPTY )
317 return sz;
319 /* add the type */
320 sz += write_dword( data, sz, prop->vt );
321 switch( prop->vt )
323 case VT_I2:
324 sz += write_dword( data, sz, prop->u.iVal );
325 break;
326 case VT_I4:
327 sz += write_dword( data, sz, prop->u.lVal );
328 break;
329 case VT_FILETIME:
330 sz += write_filetime( data, sz, &prop->u.filetime );
331 break;
332 case VT_LPSTR:
333 sz += write_string( data, sz, prop->u.pszVal );
334 break;
336 return sz;
339 static UINT save_summary_info( MSISUMMARYINFO * si, IStream *stm )
341 UINT ret = ERROR_FUNCTION_FAILED;
342 PROPERTYSETHEADER set_hdr;
343 FORMATIDOFFSET format_hdr;
344 PROPERTYSECTIONHEADER section_hdr;
345 PROPERTYIDOFFSET idofs[MSI_MAX_PROPS];
346 LPBYTE data = NULL;
347 ULONG count, sz;
348 HRESULT r;
349 int i, n;
351 /* write the header */
352 sz = sizeof set_hdr;
353 memset( &set_hdr, 0, sz );
354 set_hdr.wByteOrder = 0xfffe;
355 set_hdr.wFormat = 0;
356 set_hdr.dwOSVer = 0x00020005; /* build 5, platform id 2 */
357 /* set_hdr.clsID is {00000000-0000-0000-0000-000000000000} */
358 set_hdr.reserved = 1;
359 r = IStream_Write( stm, &set_hdr, sz, &count );
360 if( FAILED(r) || count != sz )
361 return ret;
363 /* write the format header */
364 sz = sizeof format_hdr;
365 memcpy( &format_hdr.fmtid, &FMTID_SummaryInformation, sizeof (FMTID) );
366 format_hdr.dwOffset = sizeof format_hdr + sizeof set_hdr;
367 r = IStream_Write( stm, &format_hdr, sz, &count );
368 if( FAILED(r) || count != sz )
369 return ret;
371 /* add up how much space the data will take and calculate the offsets */
372 section_hdr.cbSection = sizeof section_hdr;
373 section_hdr.cbSection += (get_property_count( si->property ) * sizeof idofs[0]);
374 section_hdr.cProperties = 0;
375 n = 0;
376 for( i = 0; i < MSI_MAX_PROPS; i++ )
378 sz = write_property_to_data( &si->property[i], NULL );
379 if( !sz )
380 continue;
381 idofs[ section_hdr.cProperties ].propid = i;
382 idofs[ section_hdr.cProperties ].dwOffset = section_hdr.cbSection;
383 section_hdr.cProperties++;
384 section_hdr.cbSection += sz;
387 data = msi_alloc_zero( section_hdr.cbSection );
389 sz = 0;
390 memcpy( &data[sz], &section_hdr, sizeof section_hdr );
391 sz += sizeof section_hdr;
393 memcpy( &data[sz], idofs, section_hdr.cProperties * sizeof idofs[0] );
394 sz += section_hdr.cProperties * sizeof idofs[0];
396 /* write out the data */
397 for( i = 0; i < MSI_MAX_PROPS; i++ )
398 sz += write_property_to_data( &si->property[i], &data[sz] );
400 r = IStream_Write( stm, data, sz, &count );
401 msi_free( data );
402 if( FAILED(r) || count != sz )
403 return ret;
405 return ERROR_SUCCESS;
408 MSISUMMARYINFO *MSI_GetSummaryInformationW( MSIDATABASE *db, UINT uiUpdateCount )
410 IStream *stm = NULL;
411 MSISUMMARYINFO *si;
412 DWORD grfMode;
413 HRESULT r;
415 TRACE("%p %d\n", db, uiUpdateCount );
417 si = alloc_msiobject( MSIHANDLETYPE_SUMMARYINFO,
418 sizeof (MSISUMMARYINFO), MSI_CloseSummaryInfo );
419 if( !si )
420 return si;
422 msiobj_addref( &db->hdr );
423 si->db = db;
424 memset( &si->property, 0, sizeof si->property );
425 si->update_count = uiUpdateCount;
427 /* read the stream... if we fail, we'll start with an empty property set */
428 grfMode = STGM_READ | STGM_SHARE_EXCLUSIVE;
429 r = IStorage_OpenStream( si->db->storage, szSumInfo, 0, grfMode, 0, &stm );
430 if( SUCCEEDED(r) )
432 load_summary_info( si, stm );
433 IStream_Release( stm );
436 return si;
439 UINT WINAPI MsiGetSummaryInformationW( MSIHANDLE hDatabase,
440 LPCWSTR szDatabase, UINT uiUpdateCount, MSIHANDLE *pHandle )
442 MSISUMMARYINFO *si;
443 MSIDATABASE *db;
444 UINT ret = ERROR_FUNCTION_FAILED;
446 TRACE("%ld %s %d %p\n", hDatabase, debugstr_w(szDatabase),
447 uiUpdateCount, pHandle);
449 if( !pHandle )
450 return ERROR_INVALID_PARAMETER;
452 if( szDatabase )
454 ret = MSI_OpenDatabaseW( szDatabase, NULL, &db );
455 if( ret != ERROR_SUCCESS )
456 return ret;
458 else
460 db = msihandle2msiinfo( hDatabase, MSIHANDLETYPE_DATABASE );
461 if( !db )
462 return ERROR_INVALID_PARAMETER;
465 si = MSI_GetSummaryInformationW( db, uiUpdateCount );
466 if (si)
468 *pHandle = alloc_msihandle( &si->hdr );
469 if( *pHandle )
470 ret = ERROR_SUCCESS;
471 else
472 ret = ERROR_NOT_ENOUGH_MEMORY;
473 msiobj_release( &si->hdr );
476 if( db )
477 msiobj_release( &db->hdr );
479 return ret;
482 UINT WINAPI MsiGetSummaryInformationA(MSIHANDLE hDatabase,
483 LPCSTR szDatabase, UINT uiUpdateCount, MSIHANDLE *pHandle)
485 LPWSTR szwDatabase = NULL;
486 UINT ret;
488 TRACE("%ld %s %d %p\n", hDatabase, debugstr_a(szDatabase),
489 uiUpdateCount, pHandle);
491 if( szDatabase )
493 szwDatabase = strdupAtoW( szDatabase );
494 if( !szwDatabase )
495 return ERROR_FUNCTION_FAILED;
498 ret = MsiGetSummaryInformationW(hDatabase, szwDatabase, uiUpdateCount, pHandle);
500 msi_free( szwDatabase );
502 return ret;
505 UINT WINAPI MsiSummaryInfoGetPropertyCount(MSIHANDLE hSummaryInfo, UINT *pCount)
507 MSISUMMARYINFO *si;
509 TRACE("%ld %p\n",hSummaryInfo, pCount);
511 si = msihandle2msiinfo( hSummaryInfo, MSIHANDLETYPE_SUMMARYINFO );
512 if( !si )
513 return ERROR_INVALID_HANDLE;
515 if( pCount )
516 *pCount = get_property_count( si->property );
517 msiobj_release( &si->hdr );
519 return ERROR_SUCCESS;
522 static UINT get_prop( MSIHANDLE handle, UINT uiProperty, UINT *puiDataType,
523 INT *piValue, FILETIME *pftValue, awstring *str, DWORD *pcchValueBuf)
525 MSISUMMARYINFO *si;
526 PROPVARIANT *prop;
527 UINT ret = ERROR_SUCCESS;
529 TRACE("%ld %d %p %p %p %p %p\n", handle, uiProperty, puiDataType,
530 piValue, pftValue, str, pcchValueBuf);
532 si = msihandle2msiinfo( handle, MSIHANDLETYPE_SUMMARYINFO );
533 if( !si )
534 return ERROR_INVALID_HANDLE;
536 if ( uiProperty >= MSI_MAX_PROPS )
538 *puiDataType = VT_EMPTY;
539 return ret;
542 prop = &si->property[uiProperty];
544 if( puiDataType )
545 *puiDataType = prop->vt;
547 switch( prop->vt )
549 case VT_I2:
550 if( piValue )
551 *piValue = prop->u.iVal;
552 break;
553 case VT_I4:
554 if( piValue )
555 *piValue = prop->u.lVal;
556 break;
557 case VT_LPSTR:
558 if( pcchValueBuf )
560 DWORD len = 0;
562 if( str->unicode )
564 len = MultiByteToWideChar( CP_ACP, 0, prop->u.pszVal, -1,
565 str->str.w, *pcchValueBuf );
566 len--;
568 else
570 len = lstrlenA( prop->u.pszVal );
571 if( str->str.a )
572 lstrcpynA(str->str.a, prop->u.pszVal, *pcchValueBuf );
574 if (len >= *pcchValueBuf)
575 ret = ERROR_MORE_DATA;
576 *pcchValueBuf = len;
578 break;
579 case VT_FILETIME:
580 if( pftValue )
581 memcpy(pftValue, &prop->u.filetime, sizeof (FILETIME) );
582 break;
583 case VT_EMPTY:
584 break;
585 default:
586 FIXME("Unknown property variant type\n");
587 break;
589 msiobj_release( &si->hdr );
590 return ret;
593 LPWSTR msi_suminfo_dup_string( MSISUMMARYINFO *si, UINT uiProperty )
595 PROPVARIANT *prop;
597 if ( uiProperty >= MSI_MAX_PROPS )
598 return NULL;
599 prop = &si->property[uiProperty];
600 if( prop->vt != VT_LPSTR )
601 return NULL;
602 return strdupAtoW( prop->u.pszVal );
605 UINT WINAPI MsiSummaryInfoGetPropertyA(
606 MSIHANDLE handle, UINT uiProperty, UINT *puiDataType, INT *piValue,
607 FILETIME *pftValue, LPSTR szValueBuf, DWORD *pcchValueBuf)
609 awstring str;
611 TRACE("%ld %d %p %p %p %p %p\n", handle, uiProperty, puiDataType,
612 piValue, pftValue, szValueBuf, pcchValueBuf );
614 str.unicode = FALSE;
615 str.str.a = szValueBuf;
617 return get_prop( handle, uiProperty, puiDataType, piValue,
618 pftValue, &str, pcchValueBuf );
621 UINT WINAPI MsiSummaryInfoGetPropertyW(
622 MSIHANDLE handle, UINT uiProperty, UINT *puiDataType, INT *piValue,
623 FILETIME *pftValue, LPWSTR szValueBuf, DWORD *pcchValueBuf)
625 awstring str;
627 TRACE("%ld %d %p %p %p %p %p\n", handle, uiProperty, puiDataType,
628 piValue, pftValue, szValueBuf, pcchValueBuf );
630 str.unicode = TRUE;
631 str.str.w = szValueBuf;
633 return get_prop( handle, uiProperty, puiDataType, piValue,
634 pftValue, &str, pcchValueBuf );
637 static UINT set_prop( MSIHANDLE handle, UINT uiProperty, UINT uiDataType,
638 INT iValue, FILETIME* pftValue, awcstring *str )
640 MSISUMMARYINFO *si;
641 PROPVARIANT *prop;
642 UINT type, len, ret = ERROR_SUCCESS;
644 TRACE("%ld %u %u %i %p %p\n", handle, uiProperty, uiDataType,
645 iValue, pftValue, str );
647 type = get_type( uiProperty );
648 if( type == VT_EMPTY || type != uiDataType )
649 return ERROR_DATATYPE_MISMATCH;
651 if( uiDataType == VT_LPSTR && !str->str.w )
652 return ERROR_INVALID_PARAMETER;
654 if( uiDataType == VT_FILETIME && !pftValue )
655 return ERROR_INVALID_PARAMETER;
657 si = msihandle2msiinfo( handle, MSIHANDLETYPE_SUMMARYINFO );
658 if( !si )
659 return ERROR_INVALID_HANDLE;
661 prop = &si->property[uiProperty];
663 if( prop->vt == VT_EMPTY )
665 if( !si->update_count )
667 ret = ERROR_FUNCTION_FAILED;
668 goto end;
670 si->update_count--;
672 else if( prop->vt != type )
673 goto end;
675 free_prop( prop );
676 prop->vt = type;
677 switch( type )
679 case VT_I4:
680 prop->u.lVal = iValue;
681 break;
682 case VT_I2:
683 prop->u.iVal = iValue;
684 break;
685 case VT_FILETIME:
686 memcpy( &prop->u.filetime, pftValue, sizeof prop->u.filetime );
687 break;
688 case VT_LPSTR:
689 if( str->unicode )
691 len = WideCharToMultiByte( CP_ACP, 0, str->str.w, -1,
692 NULL, 0, NULL, NULL );
693 prop->u.pszVal = msi_alloc( len );
694 WideCharToMultiByte( CP_ACP, 0, str->str.w, -1,
695 prop->u.pszVal, len, NULL, NULL );
697 else
699 len = lstrlenA( str->str.a ) + 1;
700 prop->u.pszVal = msi_alloc( len );
701 lstrcpyA( prop->u.pszVal, str->str.a );
703 break;
706 end:
707 msiobj_release( &si->hdr );
708 return ret;
711 UINT WINAPI MsiSummaryInfoSetPropertyW( MSIHANDLE handle, UINT uiProperty,
712 UINT uiDataType, INT iValue, FILETIME* pftValue, LPCWSTR szValue )
714 awcstring str;
716 TRACE("%ld %u %u %i %p %s\n", handle, uiProperty, uiDataType,
717 iValue, pftValue, debugstr_w(szValue) );
719 str.unicode = TRUE;
720 str.str.w = szValue;
721 return set_prop( handle, uiProperty, uiDataType, iValue, pftValue, &str );
724 UINT WINAPI MsiSummaryInfoSetPropertyA( MSIHANDLE handle, UINT uiProperty,
725 UINT uiDataType, INT iValue, FILETIME* pftValue, LPCSTR szValue )
727 awcstring str;
729 TRACE("%ld %u %u %i %p %s\n", handle, uiProperty, uiDataType,
730 iValue, pftValue, debugstr_a(szValue) );
732 str.unicode = FALSE;
733 str.str.a = szValue;
734 return set_prop( handle, uiProperty, uiDataType, iValue, pftValue, &str );
737 UINT WINAPI MsiSummaryInfoPersist( MSIHANDLE handle )
739 IStream *stm = NULL;
740 MSISUMMARYINFO *si;
741 DWORD grfMode;
742 HRESULT r;
743 UINT ret = ERROR_FUNCTION_FAILED;
745 TRACE("%ld\n", handle );
747 si = msihandle2msiinfo( handle, MSIHANDLETYPE_SUMMARYINFO );
748 if( !si )
749 return ERROR_INVALID_HANDLE;
751 grfMode = STGM_CREATE | STGM_READWRITE | STGM_SHARE_EXCLUSIVE;
752 r = IStorage_CreateStream( si->db->storage, szSumInfo, grfMode, 0, 0, &stm );
753 if( SUCCEEDED(r) )
755 ret = save_summary_info( si, stm );
756 IStream_Release( stm );
758 msiobj_release( &si->hdr );
760 return ret;