// This is a part of the Microsoft Foundation Classes C++ library.
// Copyright (C) Microsoft Corporation
// All rights reserved.
//
// This source code is only intended as a supplement to the
// Microsoft Foundation Classes Reference and related
// electronic documentation provided with the library.
// See these sources for detailed information regarding the
// Microsoft Foundation Classes product.

#include "stdafx.h"



// AfxIsValidString() returns TRUE if the passed pointer
// references a string of at least the given length in characters.
// A length of -1 (the default parameter) means that the string
// buffer's minimum length isn't known, and the function will
// return TRUE no matter how long the string is. The memory
// used by the string can be read-only.

BOOL AFXAPI AfxIsValidString(LPCWSTR psz, int nLength /* = -1 */)
{
	return ATL::AtlIsValidString(psz, nLength);
}

// As above, but for ANSI strings.

BOOL AFXAPI AfxIsValidString(LPCSTR psz, int nLength /* = -1 */)
{
	return ATL::AtlIsValidString(psz, nLength);
}

// AfxIsValidAddress() returns TRUE if the passed parameter points
// to at least nBytes of accessible memory. If bReadWrite is TRUE,
// the memory must be writeable; if bReadWrite is FALSE, the memory
// may be const.

BOOL AFXAPI AfxIsValidAddress(const void* p, UINT_PTR nBytes,
	BOOL bReadWrite /* = TRUE */)
{
	return ATL::AtlIsValidAddress(p, nBytes, bReadWrite);
}

// AfxIsValidAtom() returns TRUE if the passed parameter is 
// a valid local or global atom.

BOOL AfxIsValidAtom(ATOM nAtom)
{
	TCHAR sBuffer[256];
	if (GetAtomName(nAtom, sBuffer, _countof(sBuffer)))
	{
		return TRUE;
	}
	DWORD dwError = GetLastError();
	if (dwError == ERROR_INSUFFICIENT_BUFFER || dwError == ERROR_MORE_DATA)
	{
		return TRUE;
	}
	if (GlobalGetAtomName(nAtom, sBuffer, _countof(sBuffer)))
	{
		return TRUE;
	}
	dwError = GetLastError();
	if (dwError == ERROR_INSUFFICIENT_BUFFER || dwError == ERROR_MORE_DATA)
	{
		return TRUE;
	}
	return FALSE;
}

// AfxIsValidAddress() returns TRUE if the passed parameter is 
// a valid representation of a local or a global atom within a LPCTSTR.

BOOL AfxIsValidAtom(LPCTSTR psz)
{
	return HIWORD(psz) == 0L && AfxIsValidAtom(ATOM(LOWORD(psz)));
}

/////////////////////////////////////////////////////////////////////////////