IOfflineFilesSetting::SetPreference 메서드(cscobj.h)
오프라인 파일 설정과 연결된 컴퓨터별 또는 사용자별 기본 설정을 지정합니다.
구문
HRESULT SetPreference(
[in] const VARIANT *pvarValue,
[in] DWORD dwScope
);
매개 변수
[in] pvarValue
기본 설정과 연결된 값을 지정합니다.
여러 값이 기본 설정과 연결된 경우 VARIANT 형식에는 VT_ARRAY 포함되며 값은 SAFEARRAY에 저장됩니다.
[in] dwScope
설정할 기본 설정이 사용자별 또는 컴퓨터당인지를 나타냅니다. 다음 중 하나여야 합니다.
OFFLINEFILES_SETTING_SCOPE_USER(0x00000001)
사용자별 기본 설정을 지정합니다.
OFFLINEFILES_SETTING_SCOPE_COMPUTER(0x00000002)
컴퓨터별 기본 설정을 지정합니다.
반환 값
기본 설정이 성공적으로 설정되었는지 또는 오류 값이 설정되었는지 S_OK.
pvtValue를 통해 지정된 하나 이상의 데이터 값이 유효하지 않으면 를 반환 HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)
합니다.
호출자가 컴퓨터별 기본 설정을 시도 중이고 로컬 관리자가 아닌 경우 를 반환 HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)
합니다.
기본 설정에서 지원되지 않는 scope 지정되면 를 반환 HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
합니다.
설명
이 메서드는 기본 설정이 컴퓨터별 기본 설정인 경우 시스템 관리자 권한이 필요합니다.
오프라인 파일 API를 통해 정책을 설정할 수 없다는 점에 유의해야 합니다. 정책은 그룹 정책 메커니즘을 통해서만 설정할 수 있습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista |
지원되는 최소 서버 | Windows Server 2008 |
대상 플랫폼 | Windows |
헤더 | cscobj.h |
DLL | CscSvc.dll; CscObj.dll |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기