AddIScsiSendTargetPortalA 関数 (iscsidsc.h)

AddIscsiSendTargetPortal 関数は、iSCSI イニシエーター サービスが SendTargets 要求を送信するターゲット ポータルの一覧 静的ターゲット ポータルを追加します。

構文

ISDSC_STATUS ISDSC_API AddIScsiSendTargetPortalA(
  [in, optional] PSTR                  InitiatorInstance,
  [in, optional] ULONG                 InitiatorPortNumber,
  [in, optional] PISCSI_LOGIN_OPTIONS  LoginOptions,
  [in, optional] ISCSI_SECURITY_FLAGS  SecurityFlags,
                 PISCSI_TARGET_PORTALA Portal
);

パラメーター

[in, optional] InitiatorInstance

iSCSI イニシエーター サービスが sendTargets 要求 送信するために使用するイニシエーターを、指定したターゲット ポータルに送信します。 null場合、iSCSI イニシエーター サービスは、ターゲット ポータルに到達できる任意のイニシエーターを使用します。

[in, optional] InitiatorPortNumber

SendTargets 要求に使用するポート番号。 このポート番号は、Host-Bus アダプター (HBA) の送信元 IP アドレスに対応します。 ISCSI_ALL_INITIATOR_PORTS の値は、イニシエーターが現在のルーティング情報に基づいて適切なポートを選択する必要があることを示します。

[in, optional] LoginOptions

ターゲット ポータルで使用するログイン オプションを含む ISCSI_LOGIN_OPTIONS 型の構造体へのポインター。

[in, optional] SecurityFlags

イニシエーターがセッションに追加する IPsec 接続の特性を指定するビットマップ。 イニシエーターとターゲット ポータルの間の IPsec セキュリティ ポリシーが、ポータル グループ ポリシーまたはポータルへの以前の接続の結果として既に構成されている場合、SecurityFlags で指定された構成よりも既存の構成が優先され、セキュリティ ビットマップは無視されます。

ISCSI_SECURITY_FLAG_VALID フラグが 0 に設定されている場合、iSCSI イニシエーター サービスは、レジストリで定義されているセキュリティ フラグに既定値を使用します。

呼び出し元は、ビットマップで次のいずれかのフラグを設定できます。

価値	意味
ISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED	1 に設定すると、イニシエーターは IPsec トンネル モードで接続を確立する必要があります。 呼び出し元は、このフラグまたはISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED フラグを設定する必要がありますが、両方を設定する必要はありません。
ISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED	1 に設定すると、イニシエーターは IPsec トランスポート モードで接続を確立する必要があります。 呼び出し元は、このフラグまたはISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED フラグを設定する必要がありますが、両方を設定する必要はありません。
ISCSI_SECURITY_FLAG_PFS_ENABLED	1 に設定すると、イニシエーターは Perfect Forward Secrecy (PFS) モードを有効にして接続を確立する必要があります。それ以外の場合、イニシエーターは PFS モードを無効にして接続する必要があります。
ISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED	1 に設定すると、イニシエーターはアグレッシブ モードを有効にして接続を確立する必要があります。 呼び出し元は、このフラグまたはISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED フラグを設定する必要がありますが、両方を設定する必要はありません。 注 Microsoft ソフトウェア イニシエーター ドライバーはアグレッシブ モードをサポートしていません。
ISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED	1 に設定すると、イニシエーターはメイン モードを有効にして接続を確立する必要があります。 呼び出し元は、このフラグまたはISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED フラグを設定する必要がありますが、両方を設定する必要はありません。
ISCSI_SECURITY_FLAG_IKE_IPSEC_ENABLED	1 に設定すると、イニシエーターは IKE/IPsec プロトコルを有効にして接続する必要があります。それ以外の場合、IKE/IPsec プロトコルは無効になります。
ISCSI_SECURITY_FLAG_VALID	1 に設定すると、他のマスク値が有効になります。それ以外の場合、iSCSI イニシエーター サービスは、ターゲット ポータル用に以前に定義されたビットマップ値を使用するか、使用できない場合は、イニシエーター サービスがレジストリで定義されている既定値を使用します。

Portal

ターゲット検出のために SendTargets が送信されるポータルを示す ISCSI_TARGET_PORTAL 型の構造体へのポインター。

戻り値

操作が成功した場合にERROR_SUCCESSを返します。 それ以外の場合は、適切な Win32 または iSCSI エラー コードが返されます。

備考

手記

iscsidsc.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして AddIScsiSendTargetPortal を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	iscsidsc.h
ライブラリ	Iscsidsc.lib
DLL	Iscsidsc.dll

関連項目

ISCSI_LOGIN_OPTIONS

ISCSI_TARGET_PORTAL