 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function retrieves the last Windows CE Internet function error description or server response on the thread calling this function.
BOOL WINAPI InternetGetLastResponseInfo( LPDWORD lpdwError , LPTSTR lpszBuffer , LPDWORD lpdwBufferLength );
Parameters
- lpdwError
- Long pointer to a variable that receives an error message pertaining to the operation that failed.
- lpszBuffer
- Long pointer to a buffer that receives the null-terminated string that contains the error text.
- lpdwBufferLength
- Long pointer to the size of the
lpszBufferbuffer. When the function returns, this parameter
contains the size of the string written to the buffer.
Return Values
TRUE indicates that the error text was successfully written to the buffer. FALSE indicates failure. To get extended error information, call GetLastError. If the buffer is too small to hold all the error text, GetLastErrorreturns ERROR_INSUFFICIENT_BUFFER, and the lpdwBufferLengthparameter contains the minimum buffer size required to return all the error text.
Remarks
The FTP protocol can return additional text information along with most errors. This extended error information can be retrieved by using the InternetGetLastResponseInfofunction whenever GetLastErrorreturns ERROR_INTERNET_EXTENDED_ERROR (occurring after an unsuccessful function call).
The buffer pointed to by lpszBuffermust be large enough to hold both the error string and a zero terminator at the end of the string. However, note that the value returned in lpdwBufferLengthdoes not include the terminating zero.
InternetGetLastResponseInfocan be called multiple times until another Win32 Internet function is called on this thread. When another function is called, the internal buffer that is storing the last response information is cleared.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 2.0 and later Wininet.h Wininet.lib Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also