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

.SH NAME
\fBFoldStringA\fR (KERNEL32.@)
.SH SYNOPSIS
INT FoldStringA
 (
  DWORD  \fIdwFlags\fR,
  LPCSTR \fIsrc\fR,
  INT    \fIsrclen\fR,
  LPSTR  \fIdst\fR,
  INT    \fIdstlen\fR
 )

.SH DESCRIPTION
.PP
Map characters in a string. 

.SH PARAMS
\fIdwFlags\fR \fB[In]\fR  Flags controlling characters to map (\fBMAP_\fR constants from \fB"winnls.h"\fR).
.PP
\fIsrc\fR \fB[In]\fR  String to map.
.PP
\fIsrclen\fR \fB[In]\fR  Length of \fIsrc\fR, or \fB-1\fR if \fIsrc\fR is \fBNUL\fR terminated.
.PP
\fIdst\fR \fB[Out]\fR  Destination for mapped string.
.PP
\fIdstlen\fR \fB[In]\fR  Length of \fIdst\fR, or \fB0\fR to find the required length for the mapped string.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR The length of the string written to \fIdst\fR, including the terminating \fBNUL\fR. If \fIdstlen\fR is \fB0\fR, the value returned is the same, but nothing is written to \fIdst\fR, and \fIdst\fR may be \fBNULL\fR. 
.PP
\fBFailure:\fR \fB0.\fR Use \fBGetLastError(3w)\fR to determine the cause. 

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