Поделиться через


Метод IVdsServiceIscsi::RememberTargetSharedSecret (vds.h)

[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Передает общий секрет CHAP целевого объекта в службу инициатора. Этот общий секрет используется во время входа в целевой объект, когда целевой объект проверяет подлинность инициатора.

Синтаксис

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

Параметры

[in] targetId

VDS_OBJECT_ID целевого объекта с указанным общим секретом. Этот параметр является обязательным и не может быть GUID_NULL.

[in] pTargetSharedSecret

Адрес структуры VDS_ISCSI_SHARED_SECRET , содержащей общий секрет CHAP.

Возвращаемое значение

Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать коды преобразованных системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.

Возвращаемый код/значение Описание
S_OK
Общий секрет успешно запомнился.
VDS_E_INITIALIZED_FAILED
0x80042401L
Не удалось инициализировать VDS. Если приложение вызывает этот метод до завершения инициализации службы, метод блокируется до завершения инициализации. Если инициализация завершается сбоем, возвращается эта ошибка.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 R2 [только классические приложения]
Целевая платформа Windows
Header vds.h
Библиотека Uuid.lib
Распространяемые компоненты VDS 1.1

См. также раздел

IVdsIscsiTarget::RememberInitiatorSharedSecret

IVdsIscsiTarget::SetSharedSecret

IVdsServiceIscsi

IVdsServiceIscsi::SetInitiatorSharedSecret

VDS_ISCSI_SHARED_SECRET