Mètode GetCollectionItem
Prototip
GetCollectionItem Proto hHandle:HANDLE, lItem:LONG, lpszBuffer:LPSTR
Sintaxi
Invoke GetCollectionItem, hHandle, lItem, lpszBuffer
Funció
Torna la cadena d'un ítem d'una col·lecció.
Paràmetres
hHandle
"Handle" de la col·lecció.
lItem
Índex en base zero de l'ítem que es vol obtenir.
lpszBuffer
Punter a una zona de memòria ("buffer") que rebrà la cadena de l'ítem. El "buffer" ha de tenir prou espai per contenir la cadena i el caràcter nul final.
Valor de retorn
Eax/Rax torna la llargada de la cadena, en caràcters, excloënt-hi el caràcter nul final.
OBSERVACIONS: Si lItem no indica un ítem vàlid, el valor
de retorn és -1.
OBSERVACIONS: El mètode GetCollectionItem
omple lpszBuffer amb una cadena Unicode si l'aplicació s'està executant com a Unicode, o amb una cadena
ANSI si no (vegeu el mètode IsAppUnicode). Podeu utilitzar
GetCollectionItemA per obtenir cadenes ANSI en aplicacions Unicode, o
GetCollectionItemW per obtenir cadenes Unicode en aplicacions ANSI.