vpn_ext_create_context()

Create the VPN Extension context.

Synopsis:

#include <vpnext/vpn_ext_api.h>
 
VPN_EXT_PUBLIC vpn_ext_context vpn_ext_create_context(const char *extensionName, unsigned int maxMsgLen, unsigned int maxGets)

Since:

BlackBerry 10.2.0

Arguments:

extensionName

The extension name that is used by the client to open connections.

maxMsgLen

The maximum message length. If 0 is provided, a default value is used as the maximum message length.

maxGets

The maximum number of reply messages that can be queued. If 0 is provided, a default value is used as the maximum number of reply messages.

Library:

libvpn_ext (For the qcc command, use the -l vpn_ext option to link against this library)

Description:

This function creates a context that is passed into all subsequent provider calls. Before the provider is finished, it should call VPN_ExP_DestroyContext() to clean up memory that was allocated by the library.

Returns:

The VPN Extensions context structure. If the structure is NULL, then the errno value is set to indicate the error that occurred.