1.1.29.1.12 WDRV_WINC_TLSCtxHostnameCheckSet

C

WDRV_WINC_STATUS WDRV_WINC_TLSCtxHostnameCheckSet
(
    DRV_HANDLE handle,
    WDRV_WINC_TLS_HANDLE tlsHandle,
    const char *pDomainName,
    bool verifyDomain
)

Description

Sets the hostname check field of a TLS context.

Precondition

WDRV_WINC_Initialize must have been called.

WDRV_WINC_Open must have been called to obtain a valid handle.

WDRV_WINC_TLSCtxOpen must have been called to obtain a valid TLS handle.

Parameters

ParametersDescription
handleClient handle obtained by a call to WDRV_WINC_Open.
tlsHandleTLS handle obtained by a call to WDRV_WINC_TLSCtxOpen.
pDomainNamePointer to host domain name.
verifyDomainFlag indicating if domain verification 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 domain checks are performed the value of verifyDomain should always be 'true', setting this parameter to 'false' will weaken verification checks.