[This is preliminary documentation and subject to change.]
This function allocates memory for an environment handle. This handle provides a context in which connections and statements are allocated. This only fails (return SQL_ERROR) if the function fails to allocate memory for the handle. Otherwise it returns SQL_SUCCESS.