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.
|
|