IOfflineFilesSetting::SetPreference 메서드(cscobj.h)

오프라인 파일 설정과 연결된 컴퓨터별 또는 사용자별 기본 설정을 지정합니다.

구문

HRESULT SetPreference(
  [in] const VARIANT *pvarValue,
  [in] DWORD         dwScope
);

[in] pvarValue

기본 설정과 연결된 값을 지정합니다.

여러 값이 기본 설정과 연결된 경우 VARIANT 형식에는 VT_ARRAY 포함되며 값은 SAFEARRAY에 저장됩니다.

[in] dwScope

설정할 기본 설정이 사용자별 또는 컴퓨터당인지를 나타냅니다. 다음 중 하나여야 합니다.

사용자별 기본 설정을 지정합니다.

컴퓨터별 기본 설정을 지정합니다.

기본 설정이 성공적으로 설정되었는지 또는 오류 값이 설정되었는지 S_OK.

pvtValue를 통해 지정된 하나 이상의 데이터 값이 유효하지 않으면 를 반환 HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER) 합니다.

호출자가 컴퓨터별 기본 설정을 시도 중이고 로컬 관리자가 아닌 경우 를 반환 HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 합니다.

기본 설정에서 지원되지 않는 scope 지정되면 를 반환 HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) 합니다.

이 메서드는 기본 설정이 컴퓨터별 기본 설정인 경우 시스템 관리자 권한이 필요합니다.

오프라인 파일 API를 통해 정책을 설정할 수 없다는 점에 유의해야 합니다. 정책은 그룹 정책 메커니즘을 통해서만 설정할 수 있습니다.