HttpGetResultCode Function  
 
INT WINAPI HttpGetResultCode(
  HCLIENT hClient  
);

The HttpGetResultCode function reads the result code returned by the server in response to a command. The result code is a three-digit numeric code, and indicates if the operation succeeded, failed or requires additional action by the client.

Parameters

hClient
Handle to the client session.

Return Value

If the function succeeds, the return value is the result code. If the function fails, the return value is HTTP_ERROR. To get extended error information, call HttpGetLastError.

Remarks

Result codes are three-digit numeric values returned by the server. They may be broken down into the following ranges:

Value Description
100-199 Positive preliminary result. This indicates that the requested action is being initiated, and the client should expect another reply from the server before proceeding.
200-299 Positive completion result. This indicates that the server has successfully completed the requested action.
300-399 Positive intermediate result. This indicates that the requested action cannot complete until additional information is provided to the server.
400-499 Transient negative completion result. This indicates that the requested action did not take place, but the error condition is temporary and may be attempted again.
500-599 Permanent negative completion result. This indicates that the requested action did not take place.

Requirements

Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cstools11.h
Import Library: cshtpv11.lib

See Also

HttpCommand, HttpGetResultString