Compartilhar via


_getdrives

Retorna uma máscara de bits que representa nas unidades de disco disponível.

Importante

Não é possível usar essa API em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

unsigned long _getdrives( void );

Valor de retorno

Se a função tiver êxito, o valor de retorno é uma máscara de bits que representa nas unidades de disco disponível. A posição de bit 0 (o bit menos significativo) é a unidade, A posição de bit 1 é a unidade B, posição de bit 2 é a unidade C, e assim por diante. Se a função falhar, o valor de retorno será zero. Para obter informações de erro estendido, chame GetLastError.

Requisitos

Rotina

Cabeçalho necessário

_getdrives

<direct.h>

Para obter mais informações de compatibilidade, consulte Compatibilidade.

Exemplo

// crt_getdrives.c
// This program retrives and lists out
// all the logical drives that are 
// currently mounted on the machine.

#include <windows.h>
#include <direct.h>
#include <stdio.h>
#include <tchar.h>

TCHAR g_szDrvMsg[] = _T("A:\n");

int main(int argc, char* argv[]) {
   ULONG uDriveMask = _getdrives();

   if (uDriveMask == 0)
   {
      printf( "_getdrives() failed with failure code: %d\n",
              GetLastError());
   }
   else
   {
      printf("The following logical drives are being used:\n");

      while (uDriveMask) {
         if (uDriveMask & 1)
            printf(g_szDrvMsg);

         ++g_szDrvMsg[0];
         uDriveMask >>= 1;
      }
   }
}
  

Equivalente ao .NET Framework

Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Controle de diretório