Función GetStateTextA (oleacc.h)

Recupera una cadena localizada que describe el estado de un objeto para una sola marca de bits de estado predefinida. Dado que los valores de estado son una combinación de una o varias marcas de bits, los clientes llaman a esta función más de una vez para recuperar todas las cadenas de estado.

Sintaxis

UINT GetStateTextA(
  [in]  DWORD lStateBit,
  [out] LPSTR lpszState,
  [in]  UINT  cchState
);

Parámetros

[in] lStateBit

Tipo: DWORD de

Una de las constantes de estado del objeto .

[out] lpszState

Tipo: LPTSTR de

Dirección de un búfer que recibe la cadena de texto de estado. Si este parámetro es NULL, la función devuelve la longitud de la cadena de estado, no incluido el carácter NULL.

[in] cchState

Tipo: UINT de

Tamaño del búfer al que apunta el parámetro lpszStateBit. Para las cadenas ANSI, este valor se mide en bytes; para las cadenas Unicode, se mide en caracteres.

Valor devuelto

Tipo: UINT de

Si se ejecuta correctamente y si lpszStateBit no esNULL, el valor devuelto es el número de bytes (cadenas ANSI) o caracteres (cadenas Unicode) que se copian en el búfer, sin incluir el carácter terminado en null. Si lpszStateBit es NULL, el valor devuelto representa la longitud de la cadena, no incluido el carácter NULL.

Si el recurso de cadena no existe o si el parámetro lpszStateBit no es un puntero válido, el valor devuelto es cero (0). Para obtener información de error extendida, llame a GetLastError.

Observaciones

Esta función acepta solo un bit de estado a la vez, no una máscara de bits.

Requisitos