IVdsIscsiTarget::SetSharedSecret 메서드(vdshwprv.h)
[Windows 8 및 Windows Server 2012 가상 디스크 서비스 COM 인터페이스는 Windows Storage 관리 API로 대체됩니다.]
대상이 초기자를 인증할 때 CHAP 인증에 사용되는 대상 CHAP 공유 비밀을 설정합니다.
구문
HRESULT SetSharedSecret(
[in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret,
[in] LPWSTR pwszInitiatorName
);
매개 변수
[in] pTargetSharedSecret
공유 암호를 포함하는 VDS_ISCSI_SHARED_SECRET 구조체의 주소입니다. pSharedSecret 멤버가 NULL이고 ulSharedSecretSize가 0이면 SetSharedSecret 메서드는 기존 비밀을 지웁니다.
[in] pwszInitiatorName
비밀이 초기자별인 경우 공유 비밀이 연결될 iSCSI 이름을 지정하는 문자열입니다. 전달된 값은 CHAP 이름으로 사용됩니다. 주소가 NULL 이면 모든 초기자에 대한 기본 비밀에 변경 내용이 적용됩니다.
반환 값
이 메서드는 E_INVALIDARG 또는 E_OUTOFMEMORY 같은 표준 HRESULT 값과 VDS별 반환 값을 반환할 수 있습니다. HRESULT_FROM_WIN32 매크로를 사용하여 변환된 시스템 오류 코드를 반환할 수도 있습니다. 오류는 VDS 자체 또는 사용 중인 기본 VDS 공급자 에서 발생할 수 있습니다. 가능한 반환 값은 다음과 같습니다.
| 반환 코드/값 | 설명 |
|---|---|
|
공유 비밀이 성공적으로 설정되었습니다. |
|
공급자의 캐시가 손상되었습니다. 연결된 디바이스에 대한 정보를 캐시하는 공급자 내부의 소프트웨어 또는 통신 문제를 나타냅니다. 호출자는 IVdsHwProvider::Reenumerate 메서드와 IVdsHwProvider::Refresh 메서드를 사용하여 캐시를 복원할 수 있습니다. |
|
대상 개체가 더 이상 존재하지 않습니다. |
|
이 작업 또는 매개 변수 조합은 이 공급자에서 지원되지 않습니다. |
|
대상은 초기자별 공유 비밀을 지원하지 않습니다. |
설명
하드웨어 공급자는 대상 공유 비밀을 변경하도록 하위 시스템 자체를 구성해야 합니다. 보안에 사용되는 비밀은 VDS에서 유지되지 않으며 로컬 컴퓨터의 하드웨어 공급자가 유지해서는 안 됩니다. 하드웨어 공급자는 비밀을 안전한 방식으로 하위 시스템에 전송해야 하며 하위 시스템은 비밀을 유지합니다.
일부 iSCSI 대상은 각 개시자에 대해 다른 CHAP 공유 비밀 설정을 지원할 수 있습니다. 대상이 초기자별 비밀을 지원하지 않는 경우 SetSharedSecret 호출은 VDS_E_INITIATOR_SPECIFIC_NOT_SUPPORTED 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | vdshwprv.h |
| 라이브러리 | Uuid.lib |
| 재배포 가능 파일 | VDS 1.1 |
추가 정보
IVdsIscsiTarget::RememberInitiatorSharedSecret
IVdsIscsiTarget::SetSharedSecret