_lread
La
funci�n _lread lee datos del archivo
especificado. Esta funci�n se proporciona para
la compatibilidad con versiones de Windows
16-bit. Las aplicaciones basadas en Win32 deben
usar la funci�n ReadFile.
UINT _lread(
HFILE hFile, // el manipulador de archivo
LPVOID lpBuffer, // la direcci�n de buffer para la lectura de datos
UINT uBytes // la longitud, en bytes, del buffer de datos
);
Returns
El valor de retorno indica el n�mero de bytes
del archivo realmente le�dos. Si el n�mero de
lectura de bytes es menor que uBytes, la funci�n
ha alcanzado el fin de fichero (EOF) antes de
leer el n�mero especificado de bytes.
Si la funci�n falla, el valor de retorno es
HFILE_ERROR. Para conseguir informaci�n
extendida del error, llama a GetLastError.
|
_lwrite
La
funci�n de _lwrite escribe datos al archivo
especificado. Esta funci�n es proporcionada para
la compatibilidad con versiones de Windows
16-bit. Las aplicaciones basadas en Win32 deben
usar la funci�n WriteFile.
UINT _lwrite (
HFILE hFile, // el manipulador de archivo
LPCSTR lpBuffer, // la direcci�n de buffer para los datos a ser escritos
UINT uBytes // el n�mero de bytes a escribir
);
Returns
Si la funci�n tiene �xito, el valor de retorno
indica el n�mero de bytes escritos al archivo
realmente.
Si la funci�n falla, el valor de retorno es
HFILE_ERROR. Para conseguir informaci�n
extendida del error, llama a GetLastError.
|
CreateFileA / CreateFileW
La
funci�n CreateFile crea, abre, o trunca un
archivo, pipe (*), fuente de comunicaciones,
dispositivo de disco, o consola. Devuelve un
manipulador que puede usarse para acceder al
objeto. Tambi�n puede abrir y puede devolver un
manipulador para un directorio.
HANDLE CreateFile(
LPCTSTR lpFileName, // la direcci�n de nombre del archivo
DWORD dwDesiredAccess, // el modo de acceso (leer-escribir)
DWORD dwShareMode, // modo share
LPSECURITY_ATTRIBUTES lpSecurityAttributes,// la direcci�n de descriptor de seguridad
DWORD dwCreationDistribution, // c�mo crear
DWORD dwFlagsAndAttributes, // los atributos del archivo
HANDLE hTemplateFile // el manipulador de archivo con atributos para copiar
);
Returns
Si la funci�n tiene �xito, el valor del retorno
es un manipulador abierto del archivo
especificado. Si el archivo especificado existe
antes de funci�n llamada y
dwCreationDistribution es CREATE_ALWAYS o
OPEN_ALWAYS, una llamada a GetLastError devuelve
ERROR_ALREADY_EXISTS (aunque la funci�n ha
tenido �xito). Si el archivo no existe antes
de la llamada, GetLastError devuelve cero.
Si la funci�n falla, el valor del retorno es
INVALID_HANDLE_VALUE. Para conseguir informaci�n
extendida del error, llama a GetLastError. (* n.
del t.: conexi�n temporal de un programa, entre
dos programas o comandos.)
|
GetPrivateProfileIntA / GetPrivateProfileIntW
La
funci�n de GetPrivateProfileInt recupera un
entero asociado con una tecla en la secci�n
especificada del archivo de inicializaci�n dado.
Esta funci�n es proporcionada para la
compatibilidad con aplicaciones basadas en
Windows 16-bit. Aplicaciones basadas en Win32
deben guardar la informaci�n de inicializaci�n
en el registro.
UINT GetPrivateProfileInt(
LPCTSTR lpAppName, // la direcci�n de nombre de la secci�n
LPCTSTR lpKeyName, // la direcci�n de nombre de la tecla
INT nDefault, // el valor de retorno si el nombre de la tecla no es encontrado
LPCTSTR lpFileName // la direcci�n de nombre de fichero de inicializaci�n
);
Returns
Si la funci�n tiene �xito, el valor del retorno
es el entero equivalente del string que sigue al
nombre especificado de la tecla en el archivo de
inicializaci�n especificado. Si la tecla no es
encontrada, el valor de retorno es el valor
predefinido especificado. Si el valor de la tecla
es menor de cero, el valor del retorno es cero.
|
GetPrivateProfileStringA / GetPrivateProfileStringW
La
funci�n de GetPrivateProfileString recupera un
string de la secci�n especificada en un archivo
de inicializaci�n. Esta funci�n es
proporcionado para la compatibilidad con
aplicaciones basadas en Windows16-bit.
Aplicaciones basadas en Win32 deben guardar
informaci�n la de inicializaci�n en el
registro.
DWORD GetPrivateProfileString(
LPCTSTR lpAppName, // los puntos para el nombre de la secci�n
LPCTSTR lpKeyName, // los puntos para el nombre de la tecla
LPCTSTR lpDefault, // los puntos para string predefinido
LPTSTR lpReturnedString, // los puntos para el buffer de destino
DWORD nSize, // el tama�o del buffer de destino
LPCTSTR lpFileName // los puntos para el nombre del fichero de inicializaci�n
);
Returns
Si la funci�n tiene �xito, el valor de retorno
es el n�mero de caracteres copiados al buffer,
no incluyendo la terminaci�n del car�cter nulo.
Si ni lpAppName ni lpKeyName son NULL y el buffer
de destino proporcionado es demasiado peque�o
para sostener el string pedido, el string es
truncado y seguido por un car�cter nulo, y el
valor del retorno es igual a nSize menos uno.
Si o lpAppName o lpKeyName son NULL y el buffer
de destino proporcionado es demasiado peque�o
para sostener todo el strings, el �ltimo string
es truncado y seguido por dos caracteres nulos.
En este caso, el valor de retorno es igual a
nSize menos dos.
|
ReadFileA
La
funci�n de ReadFile lee datos de un archivo,
comienza en la posici�n indicada por el
indicador del archivo. Despu�s de que la
operaci�n de lectura se ha completado, el
indicador del archivo es ajustado realmente por
el n�mero de bytes le�dos, a menos que el
manipulador de archivos sea creado con el
atributo superpuesto. Si el manipulador de
archivos es creado para entrada y salida
superpuesta (I/O), la aplicaci�n debe ajustar la
posici�n del indicador del archivo despu�s de
la operaci�n de lectura.
BOOL ReadFile(
HANDLE hFile, // el manipulador de archivo para leer
LPVOID lpBuffer, // la direcci�n de buffer que recibe los datos
DWORD nNumberOfBytesToRead, // el n�mero de bytes para leer
LPDWORD lpNumberOfBytesRead, // la direcci�n de n�mero de lectura de los bytes
LPOVERLAPPED lpOverlapped // la direcci�n de estructura para el dato
);
Returns
Si la funci�n tiene �xito, el valor del retorno
es TRUE. Si el valor de retorno es que TRUE y el
n�mero de lectura de los bytes es cero, el
indicador del archivo estaba m�s all� del
extremo actual del archivo en el momento de la
operaci�n de lectura.
Si la funci�n falla, el valor de retorno es
FALSE. Para conseguir informaci�n extendida del
error, llama a GetLastError.
|
ReadFileEx
La
funci�n ReadFileEx lee datos asincr�nicamente
de un archivo. Est� dise�ado solamente para el
funcionamiento asincr�nico, a diferencia de la
funci�n ReadFile que est� dise�ado para el
funcionamiento sincr�nico y asincr�nico.
ReadFileEx permite a una aplicaci�n realizar
otro proceso durante un funcionamiento de lectura
de archivo.
La funci�n ReadFileEx informa del estado de la
realizaci�n asincr�nicamente, llamando a una
rutina de realizaci�n especificada cu�ndo la
lectura es completada y la llamada enhebrada
est� en un ciclo de espera alertado.
BOOL ReadFileEx(
HANDLE hFile, // el manipulador de archivo a leer
LPVOID lpBuffer, // la direcci�n del buffer
DWORD nNumberOfBytesToRead, // el n�mero de bytes a leer
LPOVERLAPPED lpOverlapped, // la direcci�n de offset
LPOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine // la direcci�n de realizaci�n de la rutina
);
Returns
Si la funci�n tiene �xito, el valor de retorno
es TRUE.
Si la funci�n falla, el valor de retorno es
FALSE. Para conseguir informaci�n extendida del
error, llama a GetLastError.
Si la funci�n tiene �xito, la llamada enhebrada
tiene una operaci�n I/O (entrada/salida)
as�ncrona pendiente: la operaci�n de lectura
superpuesta del archivo. Cuando esta operaci�n
de I/O se completa, y la llamada enhebrada es
bloqueada en un ciclo de espera alertado, el
sistema llama a la funci�n apuntada por
lpCompletionRoutine, y el ciclo de espera se
completa con un c�digo de retorno de
WAIT_IO_COMPLETION.
Si la funci�n tiene �xito, y la operaci�n de
lectura del archivo se completa, pero la llamada
enhebrada no est� en un ciclo de espera
alertado, el sistema pone en cola la realizaci�n
de la rutina llamada, reteniendo la llamada hasta
que la llamada enhebrada entra en un ciclo de
espera alertado. Para la informaci�n sobre la
espera alertada y operaciones superpuestas de
entrada/salida, mira Sincronizaci�n y entrada y
salida superpuestas.
Si ReadFileEx intenta leer m�s all� del extremo
del archivo, la funci�n devuelve FALSE, y
GetLastError devuelve ERROR_HANDLE_EOF.
|
SetFilePointer
La
funci�n SetFilePointer mueve el indicador del
archivo de un archivo abierto.
DWORD SetFilePointer(
HANDLE hFile, // el manipulador del archivo
LONG lDistanceToMove, // el n�mero de bytes para mover indicador del archivo
PLONG lpDistanceToMoveHigh, // la direcci�n de la palabra de alto-orden de dest. a mover
DWORD dwMoveMethod // c�mo mover
);
Returns
Si la funci�n SetFilePointer tiene �xito, el
valor de retorno es doubleword de bajo-orden del
nuevo indicador del archivo, y si
lpDistanceToMoveHigh no es NULL, la funci�n pone
el doubleword de alto-orden del nuevo indicador
del archivo en la LONG apuntada por ese
par�metro.
Si la funci�n falla y lpDistanceToMoveHigh es
NULL, el valor de retorno es 0xFFFFFFFF. Para
conseguir informaci�n extendida del error, llama
a GetLastError.
Si la funci�n falla, y lpDistanceToMoveHigh es
non-NULL, el valor de retorno es 0xFFFFFFFF y
GetLastError devolver�n un valor distinto de
NO_ERROR.
|
WriteFile
La
funci�n WriteFile escribe datos a un archivo y
est� dise�ado para la operaci�n sincr�nica y
as�ncrona. La funci�n comienza escribiendo
datos al archivo en la posici�n indicado por el
indicador del archivo. Despu�s de que la
operaci�n de escritura se ha completado, el
indicador del archivo es ajustado realmente por
el n�mero de bytes escritos, excepto cuando el
archivo es abierto con FILE_FLAG_OVERLAPPED. Si
el manipulador de archivos se creara para la
entrada y salida solapada (I/O), la aplicaci�n
debe ajustar la posici�n del indicador del
archivo despu�s de que la operaci�n de
escritura es terminada.
BOOL WriteFile(
HANDLE hFile, // el manipulador de archivo para escribir
LPCVOID lpBuffer, // la direcci�n de datos para escribir al archivo
DWORD nNumberOfBytesToWrite, // el n�mero de bytes a escribir
LPDWORD lpNumberOfBytesWritten, // la direcci�n del n�mero de bytes escritos
LPOVERLAPPED lpOverlapped // la direc. de estructura necesaria para I/O solapada
);
Returns
Si la funci�n tiene �xito, el valor de retorno
es TRUE.
Si la funci�n falla, el valor del retorno es
FALSE. Para conseguir informaci�n extendida del
error, llama a GetLastError.
|
WriteFileEx
La
funci�n WriteFileEx escribe datos a un archivo.
Est� dise�ado solamente para el funcionamiento
as�ncrono, es diferente a WriteFile que esta
dise�ado para el funcionamiento sincr�nico y
as�ncrono.
WriteFileEx informa del estado de la realizaci�n
asincr�nicamente, llamando a una rutina de
realizaci�n especificada cuando la escritura es
completada y la llamada enhebra est� en un ciclo
de espera alertado.
BOOL WriteFileEx(
HANDLE hFile; // el manipulador para el fichero de salida
LPCVOID lpBuffer; // el indicador para el buffer de entrada
DWORD nNumberOfBytesToWrite; // el n�mero de bytes a escribir
LPOVERLAPPED lpOverlapped; // el indicador para datos as�ncronos de i/o
LPOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine; // ptr. para la realizaci�n de la rutina
);
Returns
Si la funci�n tiene �xito, el valor del retorno
es VERDADERO.
Si la funci�n falla, el valor del retorno es
FALSO. Para conseguir informaci�n del error
extendida, llama GetLastError.
Si la funci�n de WriteFileEx tiene �xito, la
llamada enhebrada tiene una operaci�n I/O
(entrada/salida) as�ncrona pendiente: la
operaci�n de escritura superpuesta del archivo.
Cuando esta operaci�n de I/O termina, y la
llamada enhebrada est� bloqueada en un ciclo de
espera alertado, el sistema operativo llama a la
funci�n apuntada por lpCompletionRoutine, y la
espera se completa con un c�digo de retorno de
WAIT_IO_COMPLETION.
Si la funci�n tiene �xito y la operaci�n de
escritura del archivo termina, pero la llamada
enhebrada no est� en un ciclo de espera
alertado, el sistema pone en cola la llamada a
*lpCompletionRoutine, sosteniendo la llamada
hasta que la llamada enhebrada entra en un ciclo
de espera alertado. Mira Sincronizaci�n para
m�s informaci�n sobre estados de espera
alertados y operaciones de entrada/salida
superpuestas.
|
WritePrivateProfileStringA /
WritePrivateProfileStringW
Si
la funci�n copia el string con �xito al archivo
de inicializaci�n, el valor de retorno es TRUE.
Si la funci�n falla, o si accede a una versi�n
oculta del archivo de inicializaci�n vaciada
recientemente, el valor de retorno es FALSE. Para
conseguir informaci�n extendida del error, llama
a GetLastError.
BOOL WritePrivateProfileString(
LPCTSTR lpszSection, // la direcci�n de nombre de la secci�n
LPCTSTR lpszKey, // la direcci�n de nombre de la tecla
LPCTSTR lpszString, // la direcci�n de string a agregar
LPCTSTR lpszFile // la direcci�n de nombre de fichero de inicializaci�n
);
Returns
Si la funci�n copia el string con �xito al
archivo de inicializaci�n, el valor de retorno
es TRUE. Si la funci�n falla, o si accede a una
versi�n oculta del archivo de inicializaci�n
vaciada recientemente, el valor de retorno es
FALSE. Para conseguir informaci�n extendida del
error, llama a GetLastError.
(n. del t.: S�
que esta repetido, pero en el original viene as�
�?)
|
|
TX. Notas del
Traductor
Revisado por
X-Grimator.