OpenSSL: Fix the same BIO_FLAGS macro definition

Also add comment to the public header to avoid
making another conflict in future.

Reviewed by: jkim
Obtained from: OpenSSL commit 5d4975ecd88ac17d0749513a8fac9a7c7befd900
Sponsored by: Netflix
Differential Revision: https://reviews.freebsd.org/D34135

(cherry picked from commit aa7208254996a66fb0b363bb696fe65d81335d81)