File: gpgme.info,  Node: Creating Contexts,  Next: Contexts.php">Destroying Contexts,  Up: Contexts

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).