IVdsServiceIscsi：：RememberTargetSharedSecret 方法 (vds.h)

[从 Windows 8 和 Windows Server 2012 开始，虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

将目标的 CHAP 共享机密传达给发起方服务。当目标对发起程序进行身份验证时，在目标登录期间使用此共享机密。

语法

HRESULT RememberTargetSharedSecret(
  [in] VDS_OBJECT_ID           targetId,
  [in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret
);

[in] targetId

具有指定共享机密的目标 VDS_OBJECT_ID 。此参数是必需的，不能GUID_NULL。

[in] pTargetSharedSecret

包含 CHAP 共享机密的VDS_ISCSI_SHARED_SECRET 结构的地址。

此方法可以返回标准 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及特定于 VDS 的返回值。它还可以使用 HRESULT_FROM_WIN32 宏返回转换的系统错误代码。错误可能源自 VDS 本身或正在使用的基础 VDS 提供程序。可能的返回值包括以下内容。

返回代码/值	说明
S_OK	已成功记住共享机密。
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS 初始化失败。如果应用程序在服务完成初始化之前调用此方法，则会阻止该方法，直到初始化完成。如果初始化失败，则返回此错误。