GetDiskFreeSpaceEx

9/8/2008

Essa função obtém o seguinte informações sobre o disponível quantidade de espaço em um volume disco:

• Total de quantidade de espaço
• Quantidade de espaço livre
• Quantidade de espaço livre disponível para o usuário associado com o segmento chamado

Syntax

BOOL GetDiskFreeSpaceEx( 
  LPCWSTR lpDirectoryName, 
  PULARGE_INTEGER lpFreeBytesAvailableToCaller, 
  PULARGE_INTEGER lpTotalNumberOfBytes, 
  PULARGE_INTEGER lpTotalNumberOfFreeBytes 
);

Parameters

• lpDirectoryName
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que especifica um Diretório no disco especificado. Esta seqüência de caracteres podem ser um nome Universal Naming Convention (UNC).

  Se este parâmetro for definido como NULL, essa função obtém informações sobre como armazenar o objeto.

  Observação

  Este parâmetroNão é necessário especificar o Diretório raiz em um disco.Essa função aceita qualquer Diretório no disco.

• lpFreeBytesAvailableToCaller
  [out] Ponteiro para uma variável para receber o número de livre bytes sobre o disco que estão disponível para o usuário associado com o segmento chamado.

• lpTotalNumberOfBytes
  [out] Ponteiro para uma variável para receber o número de bytes no disco que estão disponível para o usuário associado com o segmento chamado.

• lpTotalNumberOfFreeBytes
  [out] Ponteiro para uma variável para receber o número total de livre bytes sobre o disco.

  Este parâmetro pode ser definido como NULL.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Os valores obtidos por essa função são do tipo ULARGE_INTEGER. Não esqueça não truncar esses valores para 32 bits.

Quando criptografia Mobile está habilitado, o comportamento de relatórios de alterações essa função. Cada arquivo criptografado tem pelo menos 4-página KB de sobrecarga associado. Essa função leva essa sobrecarga em conta quando ele informa a quantidade PF espaço disponível. Isto é, se um 128 - disco KB contém um único 60 - arquivo KB, essa função relata que 64 KB está disponível, subtraindo o espaço ocupado pelo arquivo e sua associado sobrecarga.

Embora essa função relata o total disponível espaço, manter a requisitos de espaço de arquivos criptografados em mente ao estimar se múltiplo novos arquivos será encaixam o espaço restante. Incluir o quantidade de espaço exigido para sobrecarga quando Mobile Encryption for habilitado. Cada arquivo requer um at least 4 KB adicionais. De exemplo, um único 60 - arquivo KB requer 64 KB, mas duas 30 - KB arquivos realmente requerem 68 KB.

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

File I/O Functions