HrStrAToStrA

The HrStrAToStrA function creates a copy of an ANSI string as an ANSI string using the MAPI MAPIAllocateBuffer function.

Quick Info

Header file: EDKUTILS.H
Library: EDKUTILS.LIB
Unicode: No (see Remarks)

HRESULT HrStrAToStrA(
  LPSTR lpszSource,  
  LPSTR * lppszDest  
);
 

Parameters

lpszSource
Input parameter. ANSI source string.
lppszDest
Output parameter. ANSI destination string.

Return Values

See Return Values.

Remarks

The HrStrAToStrA function is useful for creating macros involving TCHAR strings. You must release the destination string buffer with the MAPI MAPIFreeBuffer function before your routine exits.

When Unicode is undefined, the following macros are defined as this function:

HrStrToStr( LPTSTR lpszSource, LPTSTR * lppszDest )

HrStrAToStr( LPSTR lpszSource, LPTSTR * lppszDest )

HrStrToStrA( LPTSTR lpszSource, LPSTR * lppszDest )

For information about the MAPIAllocateBuffer and MAPIFreeBuffer functions, see the MAPI Programmer's Reference.

See Also

HrStrAToStrW, HrStrTokAll, HrStrWToStrA, HrStrWToStrW