Compartilhar via


Função CreateDirectoryFromAppW (fileapifromapp.h)

Cria um novo diretório. O comportamento dessa função é idêntico a CreateDirectory, exceto que essa função segue o modelo de segurança do aplicativo Plataforma Universal do Windows.

Sintaxe

WINSTORAGEAPI BOOL CreateDirectoryFromAppW(
  LPCWSTR               lpPathName,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes
) noexcept;

Parâmetros

lpPathName

O caminho do diretório a ser criado.

Para obter informações sobre como recusar a limitação de MAX_PATH sem acrescentar "\\?\", consulte a seção "Limitação máxima do comprimento do caminho" de Arquivos de Nomenclatura, Caminhos e Namespaces para obter detalhes.

lpSecurityAttributes

Um ponteiro para uma estrutura SECURITY_ATTRIBUTES . O membro lpSecurityDescriptor da estrutura especifica um descritor de segurança para o novo diretório. Se lpSecurityAttributes for NULL, o diretório obterá um descritor de segurança padrão. As ACLs no descritor de segurança padrão para um diretório são herdadas de seu diretório pai.

O sistema de arquivos de destino deve dar suporte à segurança em arquivos e diretórios para que esse parâmetro tenha um efeito.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Os possíveis erros incluem o seguinte.

Código de retorno Descrição
ERROR_ALREADY_EXISTS

O diretório especificado já existe.

ERROR_PATH_NOT_FOUND

Um ou mais diretórios intermediários não existem; essa função criará apenas o diretório final no caminho.

Requisitos

   
Cliente mínimo com suporte Windows 10, versão 1803
Cabeçalho fileapifromapp.h