Table of Contents
Advertisement
6. LIBRARY FUNCTIONS
6.1.4 Control functions for the general purpose external contact outputs
(GendoControl and GendoControlEx)
Use the GendoControl and GendoControlEx functions to control the outputs to the general
purpose external contacts of the RAS external contacts interface.
(1) Function interface (GendoControl)
<Name>
GendoControl - Output control for the general purpose external contact (GENDO0)
<Syntax>
#include <w2kras.h>
BOOL GendoControl(DWORD dwCmd);
<Description>
This function performs the action specified by dwCmd on the general purpose external
contact (GENDO0) of the RAS external contacts interface.
This function is for backward compatibility only.
Table 6-3 shows a list of actions that can be specified by dwCmd.
Table 6-3 List of Actions of the GendoControl Function Specified by dwCmd
dwCmd
GENDO_OPEN (0x00)
GENDO_CLOSE (0x01)
If a value other than the above is specified, this function terminates with an error. If you call
the GetLastError Windows API function, an error code W2KRAS_INVALID_PARAMETER
is returned.
<Diagnosis>
If this function completes successfully, the function returns TRUE. If this function terminates
with an error, the function returns FALSE.
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_INVALID_PARAMETER
(0x2001)
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.
Explanation of the action
Opens the general purpose external contact (GENDO0).
Closes the general purpose external contact (GENDO0).
There is an error in the specified parameters.
Startup of the RAS software has not completed yet.
An internal error has been generated.
6-8
Description
Advertisement
Table of Contents
