Condividi tramite


Funzione CreateDirectoryFromAppW (fileapifromapp.h)

Crea una nuova cartella. Il comportamento di questa funzione è identico a CreateDirectory, ad eccezione del fatto che questa funzione rispetta il modello di sicurezza delle app della piattaforma UWP (Universal Windows Platform).

Sintassi

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

Parametri

lpPathName

Percorso della directory da creare.

Per informazioni su come rifiutare esplicitamente la limitazione di MAX_PATH senza anteporre "\\?\", vedere la sezione "Limitazione massima della lunghezza del percorso" di Denominazione di file, percorsi e spazi dei nomi per informazioni dettagliate.

lpSecurityAttributes

Puntatore a una struttura SECURITY_ATTRIBUTES . Il membro lpSecurityDescriptor della struttura specifica un descrittore di sicurezza per la nuova directory. Se lpSecurityAttributes è NULL, la directory ottiene un descrittore di sicurezza predefinito. Gli elenchi di controllo di accesso nel descrittore di sicurezza predefinito per una directory vengono ereditati dalla directory padre.

Il file system di destinazione deve supportare la sicurezza dei file e delle directory affinché questo parametro abbia effetto.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError. I possibili errori includono quanto segue.

Codice restituito Description
ERROR_ALREADY_EXISTS

La directory specificata esiste già.

ERROR_PATH_NOT_FOUND

Una o più directory intermedie non esistono; questa funzione creerà solo la directory finale nel percorso.

Requisiti

Requisito Value
Client minimo supportato Windows 10, versione 1803
Header fileapifromapp.h
Library OneCore.Lib