Метод IAccIdentity::GetIdentityString (oleacc.h)

  • Статья

Извлекает строку байтов (строку идентификатора), которая однозначно идентифицирует доступный элемент.

Если разработчики серверов знают HWND объекта, который они хотят добавить, они могут использовать один из следующих методов вместо использования этого метода и получения строки удостоверения.

Синтаксис

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

Параметры

[in] dwIDChild

Тип: DWORD

Указывает, какой дочерний элемент объекта IAccessible требуется идентифицировать вызывающим объектом.

[out] ppIDString

Тип: BYTE**

Адрес переменной, которая получает указатель на строку идентификации, выделяемую вызываемым объектом. Вызываемый выделяет строку удостоверения с помощью CoTaskMemAlloc; по завершении вызывающий объект должен освободить строку удостоверения с помощью CoTaskMemFree .

[out] pdwIDStringLen

Тип: DWORD*

Адрес переменной, которая получает длину (в байтах) строки идентификации, выделяемой вызываемым объектом.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK, за исключением исключительных условий ошибок, таких как нехватка памяти. Если не поддерживается, вызов QueryInterface для IAccIdentity должен завершиться ошибкой.

Комментарии

Возвращаемая строка должна считаться непрозрачной; клиенты должны использовать его только в целом и не должны пытаться его вскрыть или иным образом интерпретировать вручную.

Если клиент знает или ожидает, что строка основана на HWND, он может использовать IAccPropServices::D ecomposeHwndIdentityString , чтобы попытаться разложить строку удостоверения.

Требования

   
Минимальная версия клиента Windows Vista или Windows XP
Минимальная версия сервера Windows Server 2003
Целевая платформа Windows
Header oleacc.h (сначала включите OleAcc.h Include Initguid.h.)
DLL Oleacc.dll
Распространяемые компоненты Активные специальные возможности 2.0 RDK в Windows NT 4.0 с пакетом обновления 6 (SP6) и более поздних версий и Windows 98