| _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í
                ¿?)
 |  
 |