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

.SH NAME
\fBAddMRUStringW\fR (COMCTL32.401)
.SH SYNOPSIS
INT AddMRUStringW
 (
  HANDLE  \fIhList\fR,
  LPCWSTR \fIlpszString\fR
 )

.SH DESCRIPTION
.PP
Add an item to an \fBMRU\fR string list. 

.SH PARAMS
\fIhList\fR \fB[In]\fR  Handle to list.
.PP
\fIlpszString\fR \fB[In]\fR  The string to add.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR The number corresponding to the registry name where the string has been stored (\fB0\fR maps to \fB'a'\fR, \fB1\fR to \fB'b'\fR and so on). 
.PP
\fBFailure:\fR \fB-1\fR, if \fIhList\fR is \fBNULL\fR or memory allocation fails. If \fIlpszString\fR is invalid, the function returns \fB0\fR, and \fBGetLastError(3w)\fR returns \fBERROR_INVALID_PARAMETER\fR. The last error value is set only in this case. 

.SH NOTES
.PP
\fB-\fRIf \fIlpszString\fR exists in the list already, it is moved to the top of the \fBMRU\fR list (it is not duplicated). 
.PP
\fB-\fRIf the list is full the least recently used list entry is replaced with \fIlpszString\fR. 
.PP
\fB-\fRIf this function returns \fB0\fR you should check the last error value to ensure the call really succeeded. 

.SH IMPLEMENTATION
.PP
Not declared in a Wine header. The function is either undocumented, or missing from Wine. 
.PP
Implemented in \fB"dlls/comctl32/comctl32undoc.c"\fR. 
.PP
Debug channel \fB"commctrl"\fR.