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

.SH NAME
\fBStrRetToBufA\fR (SHLWAPI.@)
.SH SYNOPSIS
HRESULT StrRetToBufA
 (
  LPSTRRET          \fIsrc\fR,
  const ITEMIDLIST* \fIpidl\fR,
  LPSTR             \fIdest\fR,
  UINT              \fIlen\fR
 )

.SH DESCRIPTION
.PP
Convert a \fBSTRRET\fR to a normal string. 

.SH PARAMS
lpStrRet \fB[Out]\fR  \fBSTRRET\fR to convert.
.PP
pIdl \fB[In]\fR  \fBITEMIDLIST\fR for lpStrRet\fI->uType\fR == \fBSTRRET_OFFSET\fR.
.PP
lpszDest \fB[Out]\fR  Destination for normal string.
.PP
dwLen \fB[In]\fR  Length of lpszDest.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR \fBS_OK\fR. lpszDest contains up to dwLen characters of the string. If lpStrRet is of type \fBSTRRET_WSTR\fR, its memory is freed with CoTaskMemFree() and its type set to \fBSTRRET_CSTRA\fR. 
.PP
\fBFailure:\fR \fBE_FAIL\fR, if any parameters are invalid. 

.SH IMPLEMENTATION
.PP
Declared in \fB"shlwapi.h"\fR. 
.PP
Implemented in \fB"dlls/shlwapi/string.c"\fR. 
.PP
Debug channel \fB"shell"\fR.