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

.SH NAME
\fBMultiByteToWideChar\fR (KERNEL32.@)
.SH SYNOPSIS
INT MultiByteToWideChar
 (
  UINT   \fIpage\fR,
  DWORD  \fIflags\fR,
  LPCSTR \fIsrc\fR,
  INT    \fIsrclen\fR,
  LPWSTR \fIdst\fR,
  INT    \fIdstlen\fR
 )

.SH DESCRIPTION
.PP
Convert a multibyte character string into a Unicode string. 

.SH PARAMS
\fIpage\fR \fB[In]\fR  Codepage character set to convert from.
.PP
\fIflags\fR \fB[In]\fR  Character mapping \fIflags\fR.
.PP
\fIsrc\fR \fB[In]\fR  Source string buffer.
.PP
\fIsrclen\fR \fB[In]\fR  Length of \fIsrc\fR (in bytes), or \fB-1\fR if \fIsrc\fR is \fBNUL\fR terminated.
.PP
\fIdst\fR \fB[Out]\fR  Destination buffer.
.PP
\fIdstlen\fR \fB[In]\fR  Length of \fIdst\fR (in WCHARs), or \fB0\fR to compute the required length.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR If \fIdstlen\fR > \fB0\fR, the number of characters written to \fIdst\fR. If \fIdstlen\fR == \fB0\fR, the number of characters needed to perform the conversion. In both cases the count includes the terminating \fBNUL\fR. 
.PP
\fBFailure:\fR \fB0.\fR Use \fBGetLastError(3w)\fR to determine the cause. Possible errors are \fBERROR_INSUFFICIENT_BUFFER\fR, if not enough space is available in \fIdst\fR and \fIdstlen\fR != 0; \fBERROR_INVALID_PARAMETER\fR, if an invalid parameter is passed, and \fBERROR_NO_UNICODE_TRANSLATION\fR if no translation is possible for \fIsrc\fR. 

.SH IMPLEMENTATION
.PP
Declared in \fB"winnls.h"\fR. 
.PP
Implemented in \fB"dlls/kernel32/locale.c"\fR. 
.PP
Debug channel \fB"nls"\fR.