|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| kernel32.lib
| Header File
| winbase.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
IsBadStringPtr
The IsBadStringPtr function verifies that the calling process has read access to a range of
memory pointed to by a string pointer.
BOOL IsBadStringPtr(
LPCTSTR lpsz,
| // address of string
| UINT ucchMax
| // maximum size of string
| );
|
|
Parameters
lpsz
Points to a null-terminated string, either Unicode or ASCII.
ucchMax
Specifies the maximum size, in characters, of the string. The function checks
for read access in all bytes up to the string's terminating null character or
up to the number of bytes specified by this parameter, whichever is smaller. If
this parameter is zero, the return value is zero.
Return Values
If the calling process has read access to all bytes up to the string's
terminating null character or up to the number of bytes specified by ucchMax, the return value is zero.
If the calling process does not have read access to all bytes up to the
string's terminating null character or up to the number of bytes specified by ucchMax, the return value is nonzero. To get extended error information, call GetLastError
Remarks
If the calling process has read access to some, but not all, of the bytes in
the specified memory range, the return value is nonzero.
In a preemptive multitasking environment, it is possible for some other thread
to change the process's access to the memory being tested. Even when the
function indicates that the process has read access to the specified memory, you
should use structured exception handling when attempting to access the memory. Use
of structured exception handling enables the system to notify the process if
an access violation exception occurs, giving the process an opportunity to
handle the exception.
See Also
IsBadCodePtr, IsBadHugeReadPtr, IsBadHugeWritePtr, IsBadReadPtr, IsBadWritePtr
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
