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

서버는 SetPropServer 를 사용하여 액세스 가능한 요소에 대한 속성 배열에 주석을 추가하는 데 사용할 콜백 개체를 지정합니다. 주석을 이 액세스 가능한 요소에 적용할지 아니면 요소와 해당 자식에 적용할지 여부를 지정할 수도 있습니다. 이 메서드는 서버 주석에 사용됩니다.

서버 개발자가 주석을 달려는 액세스 가능한 요소의 HWND 를 알고 있는 경우 IAccPropServices::SetHwndPropServer를 사용할 수 있습니다.

구문

HRESULT SetPropServer(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

매개 변수

[in] pIDString

형식: const BYTE*

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

[in] dwIDStringLen

형식: DWORD

pIDString 매개 변수로 식별되는 문자열의 길이를 지정합니다.

[in] paProps

형식: const MSAAPROPID*

지정된 콜백 개체에서 처리할 속성의 배열을 지정합니다.

[in] cProps

형식: int

지정된 콜백 개체에서 처리할 속성의 배열을 지정합니다.

[in] pServer

형식: IAccPropServer*

클라이언트가 재정의된 속성 중 하나를 요청할 경우 호출할 콜백 개체를 지정합니다.

[in] annoScope

형식: AnnoScope

주석이 표시된 액세스 가능 요소에만 적용됨을 나타내는 ANNO_THIS이거나 해당 요소와 요소의 직접 자식에 적용됨을 나타내는 ANNO_CONTAINER일 수 있습니다.

반환 값

형식: HRESULT

성공하면 S_OK를 반환합니다.

paProps 배열의 속성이 지원되지 않는 속성, ID 문자열이 유효하지 않거나 annoScope가 ANNO_THIS 또는 ANNO_CONTAINER 중 하나가 아닌 경우 E_INVALIDARG 반환합니다.

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

설명

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

주석 런타임은 AddRef 를 사용하여 pServer 콜백 개체에 대한 참조 카운터를 적절하게 증가합니다. 호출자는 이 메서드를 호출한 후 해제 할 수 있습니다. 주석을 달고 있는 액세스 가능한 요소가 더 이상 사용되지 않으면 주석 런타임이 콜백 개체를 자동으로 해제합니다.

요구 사항

지원되는 최소 클라이언트	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