Método IAccPropServices::SetPropServer (oleacc.h)

Os servidores usam SetPropServer para especificar um objeto de retorno de chamada a ser usado para anotar uma matriz de propriedades para o elemento acessível. Você também pode especificar se a anotação deve ser aplicada a esse elemento acessível ou ao elemento e seus filhos. Esse método é usado para anotação de servidor.

Se os desenvolvedores de servidores souberem o HWND do elemento acessível que desejam anotar, eles poderão usar IAccPropServices::SetHwndPropServer.

Sintaxe

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

Parâmetros

[in] pIDString

Tipo: const BYTE*

Identifica o elemento acessível que deve ser anotado.

[in] dwIDStringLen

Tipo: DWORD

Especifica o comprimento da cadeia de caracteres identificada pelo parâmetro pIDString.

[in] paProps

Tipo: const MSAAPROPID*

Especifica uma matriz de propriedades a ser tratada pelo objeto de retorno de chamada especificado.

[in] cProps

Tipo: int

Especifica uma matriz de propriedades a ser tratada pelo objeto de retorno de chamada especificado.

[in] pServer

Tipo: IAccPropServer*

Especifica o objeto de retorno de chamada, que será chamado quando um cliente solicita uma das propriedades substituídas.

[in] annoScope

Tipo: AnnoScope

Pode ser ANNO_THIS, indicando que a anotação afeta o elemento indicado acessível apenas; ou ANNO_CONTAINER, indicando que ele se aplica ao elemento e a seus filhos do elemento imediatos.

Valor retornado

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Retornará E_INVALIDARG se alguma das propriedades na matriz paProps não tiver suporte, se a cadeia de caracteres de identidade não for válida ou se annoScope não for um dos ANNO_THIS ou ANNO_CONTAINER.

Pode retornar outros códigos de erro em condições de erro excepcionais, como memória insuficiente.

Comentários

Consulte a seção de suporte para obter uma lista de propriedades com suporte e seus tipos esperados.

O tempo de execução de anotação usará AddRef para incrementar o contador de referência para o objeto de retorno de chamada pServer adequadamente. O chamador está livre para Liberá-lo depois de chamar esse método. O tempo de execução da anotação liberará automaticamente o objeto de retorno de chamada depois que o elemento acessível que está sendo anotado não estiver mais sendo usado.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oleacc.h (inclua OleAcc.h Include Initguid.h primeiro.)
DLL	Oleacc.dll
Redistribuível	Active Accessibility 2.0 RDK no Windows NT 4.0 com SP6 e posterior e Windows 98