1.1.19.9 WDRV_WINC_TLSCtxCACertFileSet

Function

WDRV_WINC_STATUS WDRV_WINC_TLSCtxCACertFileSet
(
DRV_HANDLE handle,
WDRV_WINC_TLS_HANDLE tlsHandle,
const char *pCACertName,
bool peerAuth
)

Summary

Sets the certificate authority field of a TLS context.

Description

Sets the certificate authority field of a TLS context.

Precondition

WDRV_WINC_Initialize should have been called. WDRV_WINC_Open should have been called to obtain a valid handle. WDRV_WINC_TLSCtxOpen should have been called to obtain a valid TLS handle.

Parameters

handle - Client handle obtained by a call to WDRV_WINC_Open.

tlsHandle - TLS handle obtained by a call to WDRV_WINC_TLSCtxOpen.

pCACertName - Pointer to certificate authority name.

peerAuth - Flag indicating if peer authentication is enabled.

Returns

WDRV_WINC_STATUS_OK - The request has been accepted.

WDRV_WINC_STATUS_NOT_OPEN - The driver instance is not open.

WDRV_WINC_STATUS_INVALID_ARG - The parameters were incorrect.

WDRV_WINC_STATUS_REQUEST_ERROR - The request to the WINC was rejected.

Remarks

To ensure proper authentication checks are performed the value of peerAuth should always be 'true', setting this parameter to 'false' will weaken authentication checks.