Função GetVolumesFromDriveW (ntmsapi.h)
[Gerenciador de Armazenamento Removível não está mais disponível a partir do Windows 7 e do Windows Server 2008 R2.]
A função GetVolumesFromDrive recupera o volume e a letra da unidade para uma determinada unidade de mídia de armazenamento removível.
Sintaxe
DWORD GetVolumesFromDriveW(
[in] LPWSTR pszDriveName,
[out] LPWSTR *VolumeNameBufferPtr,
[out] LPWSTR *DriveLetterBufferPtr
);
Parâmetros
[in] pszDriveName
O nome da unidade de mídia de armazenamento removível.
[out] VolumeNameBufferPtr
O volume que representa a unidade de mídia de armazenamento removível.
[out] DriveLetterBufferPtr
A letra da unidade que representa a unidade de mídia de armazenamento removível.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.
Se a função falhar, o valor retornado será um dos códigos de erro do sistema .
Observações
Essa função pressupõe que haverá apenas zero ou uma partições em um disco removível, portanto, há no máximo uma letra de unidade e um nome de volume.
Nota
O cabeçalho ntmsapi.h define GetVolumesFromDrive como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | ntmsapi.h |
| biblioteca | Ntmsapi.lib |
| de DLL |
Ntmsapi.dll |
Consulte também
GetNtmsObjectInformation