Método GetCollectionItem

Prototipo

GetCollectionItem Proto hHandle:HANDLE, lItem:LONG, lpszBuffer:LPSTR

Sintaxis

Invoke GetCollectionItem, hHandle, lItem, lpszBuffer

Función

Devuelve la cadena de un ítem de una colección.

Parámetros

hHandle

"Handle" de la colección.

lItem

Índice en base cero del ítem que se quiere obtener.

lpszBuffer

Puntero a una zona de memoria ("buffer") que recibirá la cadena del ítem. El "buffer" debe tener suficiente espacio para contener la cadena y el carácter nulo final.

Valor de retorno

Eax devuelve la longitud de la cadena, en caracteres, excluyendo el carácter nulo final.

OBSERVACIONES: Si lItem no indica un ítem válido, el valor de retorno es -1.

OBSERVACIONES: El método GetCollectionItem llena lpszBuffer con una cadena Unicode si la aplicación se está ejecutando como Unicode, o con una cadena ANSI si no (vea el método IsAppUnicode). Puede utilizar GetCollectionItemA para obtener cadenas ANSI en aplicaciones Unicode, o GetCollectionItemW para obtener cadenas Unicode en aplicaciones ANSI.