.\" -*- nroff -*- .\" Generated file - DO NOT EDIT! .TH SysAllocStringLen 3w "Oct 2012" "Wine API" "Wine API" .SH NAME \fBSysAllocStringLen\fR (OLEAUT32.4) .SH SYNOPSIS BSTR SysAllocStringLen ( const OLECHAR* \fIstr\fR, unsigned int \fIlen\fR ) .SH DESCRIPTION .PP Create a \fBBSTR\fR from an \fBOLESTR\fR of a given wide character length. .SH PARAMS \fIstr\fR \fB[In]\fR Source to create \fBBSTR\fR from. .PP \fIlen\fR \fB[In]\fR Length of oleStr in wide characters. .PP .SH RETURNS .PP \fBSuccess:\fR A newly allocated \fBBSTR\fR from \fBSysAllocStringByteLen(3w)\fR .PP \fBFailure:\fR \fBNULL\fR, if \fIlen\fR is >= 0x80000000, or memory allocation fails. .SH NOTES .PP See \fBBSTR(3w)\fR, \fBSysAllocStringByteLen(3w)\fR. .SH IMPLEMENTATION .PP Declared in \fB"oleauto.h"\fR. .PP Implemented in \fB"dlls/oleaut32/oleaut.c"\fR. .PP Debug channel \fB"ole"\fR.