IAccIdentity::GetIdentityString 메서드(oleacc.h)

액세스 가능한 요소를 고유하게 식별하는 바이트 문자열(ID 문자열)을 검색합니다.

서버 개발자가 주석을 달려는 개체의 HWND 를 알고 있는 경우 이 메서드를 사용하고 ID 문자열을 가져오는 대신 다음 메서드 중 하나를 사용할 수 있습니다.

• IAccPropServices::SetHwndPropStr
• IAccPropServices::SetHwndProp
• IAccPropServices::SetHwndPropServer

구문

HRESULT GetIdentityString(
  [in]  DWORD dwIDChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

매개 변수

[in] dwIDChild

형식: DWORD

호출자가 식별하려는 IAccessible 개체의 자식 개체를 지정합니다.

[out] ppIDString

형식: BYTE**

호출 수신자가 할당한 ID 문자열에 대한 포인터를 받는 변수의 주소입니다. 호출 수신자는 CoTaskMemAlloc를 사용하여 ID 문자열을 할당합니다. 호출자는 완료되면 CoTaskMemFree 를 사용하여 ID 문자열을 해제해야 합니다.

[out] pdwIDStringLen

형식: DWORD*

호출 수신자가 할당한 ID 문자열의 길이(바이트)를 받는 변수의 주소입니다.

반환 값

형식: HRESULT

메모리 부족과 같은 예외적인 오류 조건을 제외하고 S_OK 반환합니다. 지원되지 않는 경우 IAccIdentity에서 QueryInterface를 호출하지 못합니다.

설명

반환된 문자열은 불투명으로 간주되어야 합니다. 클라이언트는 전체적으로만 사용해야 하며 해부를 시도하거나 수동으로 해석해서는 안 됩니다.

클라이언트가 문자열이 HWND 기반임을 알고 있거나 예상하는 경우 IAccPropServices::D ecomposeHwndIdentityString을 사용하여 ID 문자열의 분해를 시도할 수 있습니다.

요구 사항

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