cwbCO_GetFailedSignons

Purpose

Retrieves the number of unsuccessful security validation attempts since the last successful attempt.

Syntax

 
UINT CWB_ENTRY cwbCO_GetFailedSignons(
                             cwbCO_SysHandle       system,
                             PUSHORT               numberFailedAttempts);

Parameters

cwbCO_SysHandle system - input

Handle returned previously from cwbCO_CreateSystem or cwbCO_CreateSystemLike. It identifies the iSeries™ system.

PUSHORT numberFailedAttempts - output

A pointer to a short that will contain the number of failed logon attempts if this call is successful.

Return Codes

The following list shows common return values.

CWB_OK

Successful completion.

CWB_INVALID_API_HANDLE

Invalid system handle.

CWB_INVALID_POINTER

The numberFailedAttempts pointer is NULL.

CWB_INV_BEFORE_VALIDATE

The user ID and password that were set in the specified system object have not been validated yet, so this information is not available.

Usage

You successfully must have called cwbCO_VerifyUserIDPassword, cwbCO_Signon, or cwbCO_Connect before using this API. If you want to ensure that the value that is returned is recent, you either must call cwbCO_VerifyUserIDPassword explicitly, or set the Validate Mode to CWBCO_VALIDATE_ALWAYS before you call cwbCO_Signon or cwbCO_Connect.