Mètode OpenTextFile


Prototip

OpenTextFile Proto lpszFileName:LPSTR, dwDesiredAcces:DWord, dwCreation:DWord

Sintaxi

Invoke OpenTextFile, lpszFileName, dwDesiredAcces, dwCreation

Funció

Obre un fitxer per tal de llegir i/o escriure línies de text. El nom del fitxer pot indicar la seva ruta completa ("path").

Paràmetres

lpszFileName

Punter a l'adreça efectiva d'una cadena acabada en zero que conté el nom del fitxer que s'ha d'obrir.

dwDesiredAcces

Indica el tipus d'accés al fitxer. Pot ser qualsevol combinació dels valors següents:

ecRead GENERIC_READ El fitxer s'obre per llegir-lo.
ecWrite GENERIC_WRITE El fitxer s'obre per escriure'l.

dwCreation

Indica quina acció s'ha de portar a terme si el fitxer existeix o si no. Pot ser qualsevol combinació dels valors següents:

ecCreateNew CREATE_NEW Crea un fitxer nou. Si el fitxer ja existeix, el mètode falla.
ecCreateAlways CREATE_ALWAYS Crea un fitxer nou. Si el fitxer ja existeix, el mètode el sobreescriu.
ecOpenExisting OPEN_EXISTING Obre el fitxer només si existeix.
ecOpenAlways OPEN_ALWAYS Obre el fitxer si existeix. Si no, el mètode el crea.
ecTruncateExisting TRUNCATE_EXISTING Obre el fitxer i el posa a zero bytes.

Valor de retorn

Eax/Rax torna el "handle" del fitxer obert indicat, o INVALID_HANDLE_VALUE si el fitxer no s'ha pogut obrir.


OBSERVACIONS
: Amb el "handle" del fitxer, podeu cridar els mètodes
ReadTextLine i/o WriteTextLine per tal de llegir i/o escriure línies de text. Quan ja no necessiteu més el fitxer, tanqueu el seu "handle" cridant la funció de l'API CloseHandle.

OBSERVACIONS: El mètode OpenTextFile espera que lpszFileName sigui una cadena Unicode si la aplicació s'està executant com a Unicode, o una cadena ANSI si no (vegeu el mètode IsAppUnicode). Podeu utilitzar OpenTextFileA per obrir noms de fitxer ANSI en aplicacions Unicode, o OpenTextFileW per obrir noms de fitxer Unicode en aplicacions ANSI.