HrStrAToStrA

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

Quick Info

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