OPEN_CONNECTIONは、SMTPサービスとの接続を開き、それを返します。
機能の適用範囲
この内容はOceanBaseデータベースのOracleモードでのみ適用されます。
構文
UTL_SMTP.OPEN_CONNECTION (
host IN VARCHAR2,
port IN PLS_INTEGER DEFAULT 25,
c OUT connection,
tx_timeout IN PLS_INTEGER DEFAULT NULL,
wallet_path IN VARCHAR2 DEFAULT NULL,
wallet_password IN VARCHAR2 DEFAULT NULL,
secure_connection_before_smtp IN BOOLEAN DEFAULT FALSE,
secure_host IN VARCHAR2 DEFAULT NULL)
RETURN reply;
UTL_SMTP.OPEN_CONNECTION (
host IN VARCHAR2,
port IN PLS_INTEGER DEFAULT 25,
tx_timeout IN PLS_INTEGER DEFAULT NULL,
wallet_path IN VARCHAR2 DEFAULT NULL,
wallet_password IN VARCHAR2 DEFAULT NULL,
secure_connection_before_smtp IN BOOLEAN DEFAULT FALSE,
secure_host IN VARCHAR2 DEFAULT NULL)
RETURN connection;
パラメータの説明
パラメータ |
説明 |
|---|---|
| host | SMTPサービスのホスト名。 |
| port | smtpサービスのポート番号（通常は25）。 |
| c | smtp接続。 |
| tx_timeout | UTL_SMTPパッケージが接続の読み取りおよび書き込み操作でタイムアウトするまでの待機時間（秒単位）。読み取り操作では、すぐに読み取るデータがない場合にこのパッケージがタイムアウトします。書き込み操作では、出力バッファがいっぱいであり、ネットワークに送信されずにブロックされていないデータがない場合にこのパッケージがタイムアウトします。0は待機しないことを表し、NULLは常に待機することを表します。 |
| wallet_path | 現在このフィールドはサポートされていません。現在、このフィールドのデフォルト値はNULLです。 |
| wallet_password | 現在このフィールドはサポートされていません。現在、このフィールドのデフォルト値はNULLです。 |
| secure_connection_before_smtp | TRUEの場合、SMTP通信の前にSSL/TLSを使用してセキュリティ接続を確立します。FALSEの場合、セキュリティ接続は確立されません。（現在はFALSEのみサポートしています）。 |
| secure_host | 現在このフィールドはサポートされていません。現在、このフィールドのデフォルト値はNULLです。 |
戻り値
戻り値 |
説明 |
|---|---|
| reply | コマンドの応答です。複数の応答がある場合、最後の応答が返されます。 |
使用方法
- 期待されるreply codeは
220で、SMTPサーバーがクライアントからの要求を処理する準備ができていることを示します。 utl_smtp.connectionを返すバージョンはreply codeをチェックし、応答がエラーを示した場合は例外をスローします。utl_smtp.replyを返すバージョンは、ユーザーがreplyをチェックします。tx_timeoutは読み取り操作と書き込み操作を管理するために設計されています。しかし、実装上の制限により、現在のバージョンではtx_timeoutが書き込み操作を管理することはできません。