_getdrives

Artigo
03/12/2013

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

Importante
Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

unsigned long _getdrives( void );

Valor de retorno

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

Requisitos

Rotina	Cabeçalho necessário
_getdrives	<direct.h>

Para mais informações, consulte Compatibilidadede 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 LÍQUIDO de 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

Compartilhar via