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


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

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

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

Синтаксис

HRESULT SetInitiatorSharedSecret(
  [in] VDS_ISCSI_SHARED_SECRET *pInitiatorSharedSecret,
  [in] VDS_OBJECT_ID           targetId
);

Параметры

[in] pInitiatorSharedSecret

Адрес структуры VDS_ISCSI_SHARED_SECRET , содержащей общий секрет. Если член pSharedSecret имеет значение NULL , а ulSharedSecretSize равен нулю, метод SetInitiatorSharedSecret очищает любой существующий секрет. Если этот параметр имеет значение NULL и параметр targetId не GUID_NULL, SetInitiatorSharedSecret очищает связь между инициатором и целевым объектом.

[in] targetId

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

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

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

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

Комментарии

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

Невозможно программно определить, поддерживает ли инициатор секреты для конкретного целевого объекта. Если вызов SetInitiatorSharedSecret возвращает VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED, снова вызовите метод , задав параметру targetId значение GUID_NULL.

Инициатор программного обеспечения Microsoft iSCSI не поддерживает настройку секретов для конкретных целей.

Требования

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

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

IVdsIscsiTarget::RememberInitiatorSharedSecret

IVdsIscsiTarget::SetSharedSecret

IVdsServiceIscsi

IVdsServiceIscsi::RememberTargetSharedSecret

VDS_ISCSI_SHARED_SECRET