7.1 Creating Contexts

Function: gpgme_error_t gpgme_new (gpgme_ctx_t *ctx)

The function gpgme_new creates a new gpgme_ctx_t object and returns a handle for it in ctx.

The function returns the error code GPG_ERR_NO_ERROR if the context was successfully created, GPG_ERR_INV_VALUE if ctx is not a valid pointer, and GPG_ERR_ENOMEM if not enough memory is available. Also, it returns GPG_ERR_NOT_OPERATIONAL if gpgme_check_version was not called to initialize GPGME, and GPG_ERR_SELFTEST_FAILED if a selftest failed. Currently, the only selftest is for Windows MingW32 targets to see if -mms-bitfields was used (as required).