Função PathAllocCanonicalize (pathcch.h)
Converte uma cadeia de caracteres de caminho em uma forma canônica.
Essa função difere de PathCchCanonicalize e PathCchCanonicalizeEx , pois retorna o resultado no heap. Isso significa que o chamador não precisa declarar o tamanho da cadeia de caracteres retornada e reduz o uso da pilha.
Essa função difere de PathCanonicalize , pois aceita caminhos com prefixos "\", "\?" e "\?\UNC".
Sintaxe
WINPATHCCHAPI HRESULT PathAllocCanonicalize(
[in] PCWSTR pszPathIn,
[in] ULONG dwFlags,
[out] PWSTR *ppszPathOut
);
Parâmetros
[in] pszPathIn
Um ponteiro para um buffer que contém a cadeia de caracteres original. Esse valor não pode ser NULL.
[in] dwFlags
Um ou mais dos seguintes sinalizadores:
[out] ppszPathOut
O endereço de um ponteiro para um buffer que, quando essa função retorna com êxito, recebe a cadeia de caracteres de caminho canônica. É responsabilidade do chamador liberar esse recurso, quando ele não for mais necessário, chamando a função LocalFree . Esse valor não pode ser NULL.
Retornar valor
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Essa função dá suporte a estes formulários de caminho alternativos:
- \\?\
- \\?\\UNC\
- \\?\Volume{guid}\
Essa função não converte barras (/) em barras invertidas (\). Com a entrada não confiável, essa função por si só não pode ser usada para converter caminhos em um formulário que pode ser comparado com outros caminhos para sub-caminho ou identidade. Os chamadores que precisam dessa capacidade devem converter para frente em barras invertidas antes de usar essa função.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 8 [aplicativos da área de trabalho | Aplicativos UWP] |
Servidor mínimo com suporte | Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP] |
Plataforma de Destino | Windows |
Cabeçalho | pathcch.h |
Biblioteca | Pathcch.lib |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de