Função GetRoleTextA (oleacc.h)

Artigo
11/20/2024

Recupera a cadeia de caracteres localizada que descreve a função do objeto para o valor de função especificado.

Sintaxe

UINT GetRoleTextA(
  [in]  DWORD lRole,
  [out] LPSTR lpszRole,
  [in]  UINT  cchRoleMax
);

Parâmetros

[in] lRole

Tipo: DWORD

Uma das constantes de de função de objeto .

[out] lpszRole

Tipo: LPTSTR

Endereço de um buffer que recebe a cadeia de caracteres de texto de função. Se esse parâmetro for NULL, a função retornará o comprimento da cadeia de caracteres de função, não incluindo o caractere nulo.

[in] cchRoleMax

Tipo: UINT

O tamanho do buffer apontado pelo parâmetro lpszRole. Para cadeias de caracteres ANSI, esse valor é medido em bytes; para cadeias de caracteres Unicode, ela é medida em caracteres.

Valor de retorno

Tipo: UINT

Se tiver êxito e se lpszRole não forNULL, o valor retornado será o número de bytes (cadeias de caracteres ANSI) ou caracteres (cadeias de caracteres Unicode) copiados para o buffer, não incluindo o caractere nulo de encerramento. Se lpszRole for NULL, o valor retornado representará o comprimento da cadeia de caracteres, não incluindo o caractere nulo.

Se o recurso de cadeia de caracteres não existir ou se o parâmetro lpszRole não for um ponteiro válido, o valor retornado será zero (0). Para obter informações de erro estendidas, chame GetLastError.

Observações

Nota

O cabeçalho oleacc.h define GetRoleText como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	oleacc.h
biblioteca	Oleacc.lib
de DLL	Oleacc.dll
redistribuível	Active Accessibility 1.3 RDK no Windows NT 4.0 com SP6 e posterior e Windows 95

Compartilhar via