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.
A version of this page is also available for
4/8/2010

This function provides a method to query the LASS for values.

Syntax 

BOOL LASSGetValue(
  DWORD 
ValueId,
  PVOID 
pOutBuffer,
  DWORD 
cbOutBuffer,
  DWORD* 
pcbReturned
);

Parameters

ValueId

[in] The value the Local Authentication Plugin (LAP) wishes to query.

pOutBuffer

[out] Pointer to the output buffer.

cbOutBuffer

[in] Size of the output buffer in bytes.

pcbReturned

[out] Pointer to the actual number of bytes of output. If the buffer specified by the pOutbufferparameter is not large enough to hold the returned data, pcbReturnedstores the required buffer size, in bytes.

Return Value

Returns TRUE if the value has been returned successfully, and FALSE otherwise. To get extended error information, the application should call GetLastError. The following table shows the most common error codes:

Value Description

ERROR_INVALID_PARAMETER

One of the parameters contains an invalid value. This is most often an illegal pointer.

ERROR_MORE_DATA

If the buffer specified by the pOutbufferparameter is not large enough to hold the returned data, the function sets the ERROR_MORE_DATA code, and stores the required buffer size, in bytes, into the variable pointed to by pcbReturned.

ERROR_UNKNOWN_PROPERTY

The ValueIdparameter is not a valid Parameter Id.

Remarks

The values that can be queried are:

ValueID Description pOutBuffer

LASS_VALUE_ DEVICE_WIPE_THRESHOLD

Returns the device wipe threshold. Returns 0 if no device wipe threshold is set.

Pointer to a DWORD

LASS_VALUE_AUTH_FAILURE_COUNT

Returns the number of authentication failures. If there have been no failures, This value returns 0.

Pointer to a DWORD

If the user wishes to query for the length of a value, they may do so by calling into LASSGetValuewith a NULL output buffer.

Requirements

Header lap.h
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later, Windows Mobile 6 Standard and later

See Also

Reference

LASS Functions