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

.SH NAME
\fBSysAllocStringByteLen\fR (OLEAUT32.150)
.SH SYNOPSIS
BSTR SysAllocStringByteLen
 (
  LPCSTR \fIstr\fR,
  UINT   \fIlen\fR
 )

.SH DESCRIPTION
.PP
Create a \fBBSTR\fR from an \fBOLESTR\fR of a given byte length. 

.SH PARAMS
\fIstr\fR \fB[In]\fR  Source to create \fBBSTR\fR from.
.PP
\fIlen\fR \fB[In]\fR  Length of oleStr in bytes.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR A newly allocated \fBBSTR\fR 
.PP
\fBFailure:\fR \fBNULL\fR, if \fIlen\fR is >= 0x80000000, or memory allocation fails. 

.SH NOTES
.PP
\fB-\fRIf \fIlen\fR is \fB0\fR or oleStr is \fBNULL\fR the resulting string is empty (""). 
.PP
\fB-\fRThis function always \fBNUL\fR terminates the resulting \fBBSTR\fR. 
.PP
\fB-\fRoleStr may be either an \fBLPCSTR\fR or \fBLPCOLESTR\fR, since it is copied without checking for a terminating \fBNUL\fR. See \fBBSTR(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.