IVdsIscsiTarget::SetSharedSecret 메서드(vds.h)

아티클
03/13/2024

[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 공급자 에서 발생할 수 있습니다. 가능한 반환 값은 다음과 같습니다.

반환 코드/값	설명
S_OK	공유 비밀이 성공적으로 설정되었습니다.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	공급자의 캐시가 손상되었습니다. 연결된 디바이스에 대한 정보를 캐시하는 공급자 내부의 소프트웨어 또는 통신 문제를 나타냅니다. 호출자는 IVdsHwProvider::Reenumerate 메서드와 IVdsHwProvider::Refresh 메서드를 사용하여 캐시를 복원할 수 있습니다.
VDS_E_OBJECT_DELETED 0x8004240BL	대상 개체가 더 이상 존재하지 않습니다.
VDS_E_NOT_SUPPORTED 0x80042400L	이 작업 또는 매개 변수 조합은 이 공급자에서 지원되지 않습니다.
VDS_E_INITIATOR_SPECIFIC_NOT_SUPPORTED 0x80042707L	대상은 초기자별 공유 비밀을 지원하지 않습니다.

설명

하드웨어 공급자는 대상 공유 비밀을 변경하도록 하위 시스템 자체를 구성해야 합니다. 보안에 사용되는 비밀은 VDS에서 유지되지 않으며 로컬 컴퓨터의 하드웨어 공급자가 유지해서는 안 됩니다. 하드웨어 공급자는 비밀을 안전한 방식으로 하위 시스템에 전송해야 하며 하위 시스템은 비밀을 유지합니다.

일부 iSCSI 대상은 각 개시자에 대해 다른 CHAP 공유 비밀 설정을 지원할 수 있습니다. 대상이 초기자별 비밀을 지원하지 않는 경우 SetSharedSecret 호출은 VDS_E_INITIATOR_SPECIFIC_NOT_SUPPORTED 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	vds.h
라이브러리	Uuid.lib
재배포 가능 파일	VDS 1.1