CreateFileA
/ CreateFileW
La
función CreateFile crea, abre, o trunca un
archivo, pipe(*), recurso
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 a un directorio.
HANDLE CreateFile(
LPCTSTR lpFileName, // la dirección del 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 la llamada de función 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.)
|
GetDiskFreeSpaceA / GetDiskFreeSpaceW
La
función GetDiskFreeSpace recupera información
sobre el disco especificado, incluso la cantidad
de espacio libre en el disco.
BOOL GetDiskFreeSpace (
LPCTSTR lpRootPathName, // la dirección del path raíz
LPDWORD lpSectorsPerCluster, // la dirección de sectores por cluster
LPDWORD lpBytesPerSector, // la dirección de bytes por sector
LPDWORD lpNumberOfFreeClusters, // la dirección del número de clusters libres
LPDWORD lpTotalNumberOfClusters // la dirección del número total de clusters
);
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.
|
GetDriveTypeA / GetDriveTypeW
Determina
si una unidad de disco es un removible, fijo,
CD-ROM, disco RAM, o unidad de red.
UINT GetDriveType(
LPCTSTR lpRootPathName // la dirección del path raíz
);
Returns
0 Unidad no puede determinarse
1 Unidad no puede determinarse
2 Directorio de raíz no existe
3 Unidad fija (Harddisk)
4 Unidad remota (Red)
5 Unidad CD-ROM
6 Disco-RAM (sólo GetDriveTypeA)
|
GetFullPathNameA / GetFullPathNameW
La
función GetFullPathName recupera el path entero
y el nombre de fichero de un archivo
especificado.
DWORD GetFullPathName(
LPCTSTR lpFileName, // la dirección del nombre de archivo para encontrar el path para
NBufferLength de DWORD, // el tamaño, en caracteres, del path del buffer,
LPTSTR lpBuffer, // la dirección del path del buffer
LPTSTR *lpFilePart // la dirección de nombre de fichero en path
);
Returns
Si la función GetFullPathName tiene éxito, el
valor de retorno es la longitud, en caracteres,
del string copiado a lpBuffer, sin incluir la
terminación del carácter nulo. Si el buffer de
lpBuffer es demasiado pequeño, el valor de
retorno es el tamaño del buffer, en caracteres,
requerido para mantener el path. Si la función
falla, el valor de retorno es cero. Para
conseguir información extendida del error, llama
a GetLastError.
|
GetLogicalDrives
Devuelve
un bitmask que representan las unidades de disco
actualmente disponibles.
DWORD GetLogicalDrives(VOID);
Returns
Si la función tiene éxito, el valor de retorno
es un bitmask que representa las unidades de
disco actualmente disponibles. Bit posición 0
(el menor - el bit significativo) es unidad A,
bit posición 1 es unidad B, bit posición 2 es
unidad C, y así sucesivamente. Si la función
falla, el valor de retorno es cero.
|
GetLogicalDriveStringsA / GetLogicalDriveStringsW
Llena
un buffer con strings(*) que
especifican unidades válidas en el sistema.
DWORD GetLogicalDriveStrings(
DWORD nBufferLength, // el tamaño de buffer
LPTSTR lpBuffer // la dirección de buffer para las strings de unidad
);
Returns
Si la función tiene éxito, el valor del retorno
es la longitud, en caracteres, de los strings
copiados al buffer, sin incluir la terminación
del carácter nulo. Nota que en ANSI-ASCII el
carácter nulo usa un byte, pero en Unicode el
carácter nulo usa dos bytes.
Si el buffer no es bastante grande, el valor de
retorno es mayor que nBufferLength. Es que el
tamaño de buffer requerido para mantener las
strings de unidad. Si la función falla, el valor
de retorno es cero. Para conseguir información
extendida del error, usa la función
GetLastError.
(*
n. del t.:serie de caracteres manipulada como un
grupo.)
|
GetVolumeInformationA / GetVolumeInformationW
La
función GetVolumeInformation devuelve
información sobre un archivo del sistema y un
volumen cuyo directorio raíz se especifica.
BOOL GetVolumeInformation(
LPCTSTR lpRootPathName, // la dirección del directorio raíz del archivo del sistema
LPTSTR lpVolumeNameBuffer, // la dirección de nombre del volumen
DWORD nVolumeNameSize, // la longitud de lpVolumeNameBuffer
LPDWORD lpVolumeSerialNumber, // la dirección de número de serie de volumen
LPDWORD lpMaximumComponentLength, // la dirección de la longitud máxima de nombre de fichero de sistema
LPDWORD lpFileSystemFlags, // la dirección de banderas de archivo de sistema
LPTSTR lpFileSystemNameBuffer, // la dirección de nombre del archivo de sistema
DWORD nFileSystemNameSize // la longitud de lpFileSystemNameBuffer
);
Returns
Si toda la información pedida se recupera, el
valor del retorno es TRUE; de otro modo, es
FALSE. Para conseguir información extendida del
error, llama a GetLastError.
|
|