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

.SH NAME
\fBSysAllocString\fR (OLEAUT32.2)
.SH SYNOPSIS
BSTR SysAllocString
 (
  LPCOLESTR \fIstr\fR
 )

.SH DESCRIPTION
.PP
Create a \fBBSTR\fR from an \fBOLESTR\fR. 

.SH PARAMS
\fIstr\fR \fB[In]\fR  Source to create \fBBSTR\fR from.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR A \fBBSTR\fR allocated with \fBSysAllocStringLen(3w)\fR. 
.PP
\fBFailure:\fR \fBNULL\fR, if oleStr is \fBNULL\fR. 

.SH NOTES
.PP
See \fBBSTR(3w)\fR. \fBMSDN\fR (October \fB2001\fR) incorrectly states that \fBNULL\fR is returned if oleStr has a length of \fB0.\fR Native Win32 and this implementation both return a valid empty \fBBSTR\fR in this case. 

.SH IMPLEMENTATION
.PP
Declared in \fB"oleauto.h"\fR. 
.PP
Implemented in \fB"dlls/oleaut32/oleaut.c"\fR. 
.PP
Debug channel \fB"ole"\fR.