Função PathBuildRootW (shlwapi.h)

Cria um caminho raiz de um determinado número de unidade.

Sintaxe

LPWSTR PathBuildRootW(
  [out] LPWSTR pszRoot,
  [in]  int    iDrive
);

Parâmetros

[out] pszRoot

Tipo: LPTSTR

Um ponteiro para a cadeia de caracteres que recebe o caminho raiz construído. Esse buffer deve ter pelo menos quatro caracteres de tamanho.

[in] iDrive

Tipo: int

Uma variável do tipo int que indica o número de unidade desejado. Deve estar entre 0 e 25.

Valor retornado

Tipo: LPTSTR

Retorna o endereço do caminho raiz construído. Se a chamada falhar por algum motivo (por exemplo, um número de unidade inválido), szRoot será retornado inalterado.

Comentários

Observação

O cabeçalho shlwapi.h define PathBuildRoot como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 4.71 ou posterior)