Table of Contents
Advertisement
6. LIBRARY FUNCTIONS
6.1.5 Get functions for the general purpose external contact inputs (GetGendi and GetGendiEx)
Use the GetGendi and GetGendiEx functions to get the inputs for the general purpose
external contacts of the RAS external contacts interface.
(1) Function interface (GetGendi)
<Name>
GetGendi - Status acquisition of the general purpose external contact input (GENDI).
<Syntax>
#include <w2kras.h>
DWORD GetGendi(VOID);
<Description>
This function gets the status of the general purpose external contact input (GENDI) of the
RAS external contacts interface. This function is for backward compatibility only.
In order to use this function, in the RAS Setup window,
if remote shutdown is requested" check box
selected, this function terminates with an error. If you call the GetLastError Windows API
function, an error code W2KRAS_RMTSTDN_ON is returned.
<Return values>
1: External contact GENDI is closed.
0: External contact GENDI is open.
0xffffffff: The function terminates with an error.
<Diagnosis>
If this function terminates with an error, the function returns 0xffffffff.
When this function terminates with an error, call the GetLastError Windows API function to
get the error code. Error codes returned by this function on its own are as follows.
Error code (value)
W2KRAS_RMTSTDN_ON
(0x2003)
W2KRAS_NOT_INITIALIZE
(0x2005)
W2KRAS_INTERNAL_ERROR
(0x2007)
Other error codes come from the Windows API functions used by this function. For details
about those error codes, refer to the Windows API help.
under Shutdown setting. If this check box is
Description
This function cannot be used because the Automatically
shutdown if remote shutdown is requested check box
is selected under Shutdown setting in the RAS Setup
window.
Startup of the RAS software has not completed yet.
An internal error has been generated.
6-12
clear the "Automatically shutdown
Advertisement
Table of Contents
