IAccPropServices::ClearProps 메서드(oleacc.h)

서버는 ClearProps 를 사용하여 이전에 주석을 추가한 액세스 가능한 요소의 속성으로 기본값을 복원합니다.

서버가 지우려는 개체의 HWND 를 알고 있는 경우 IAccPropServices::ClearHwndProps를 사용할 수 있습니다.

구문

HRESULT ClearProps(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

매개 변수

[in] pIDString

형식: const BYTE*

주석을 해제할 액세스 가능 요소를 식별합니다.

[in] dwIDStringLen

형식: DWORD

pIDString의 길이입니다.

[in] paProps

형식: const MSAAPROPID*

다시 설정할 속성의 배열을 지정합니다. 이러한 속성이 주석을 추가하기 전에 표시된 기본 동작으로 돌아갑니다.

[in] cProps

형식: int

paProps 배열의 크기입니다.

반환 값

형식: HRESULT

성공하면 지정된 속성이 액세스 가능한 개체에 주석을 추가하지 않았더라도 S_OK 반환합니다. 이미 지워진 속성을 지우는 것은 성공한 것으로 간주됩니다.

paProps 배열의 속성이 지원되지 않으면 E_INVALIDARG 반환합니다.

메모리 부족과 같은 예외적인 오류 조건에서 다른 오류 코드를 반환할 수 있습니다.

설명

지원되는 속성 및 예상 형식 목록은 지원 섹션을 참조하세요.

속성에 대한 주석을 지우면 연결된 리소스가 해제됩니다. 콜백 속성 서버가 사용된 경우( SetPropServer 참조) 콜백 속성 서버가 릴리스됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	oleacc.h(먼저 OleAcc.h 포함 Initguid.h 포함).
DLL	Oleacc.dll
재배포 가능 파일	SP6 이상 및 Windows 98을 Windows NT 4.0의 활성 접근성 2.0 RDK