Funzione SHCreateDirectoryExA (shlobj_core.h)

Articolo
08/26/2023

[Questa funzione è disponibile tramite Windows XP Service Pack 2 (SP2) e Windows Server 2003. Potrebbe essere modificato o non disponibile nelle versioni successive di Windows.]

Crea una nuova cartella del file system, con attributi di sicurezza facoltativi.

Sintassi

int SHCreateDirectoryExA(
  [in, optional] HWND                      hwnd,
  [in]           LPCSTR                    pszPath,
  [in, optional] const SECURITY_ATTRIBUTES *psa
);

Parametri

[in, optional] hwnd

Tipo: HWND

Handle di una finestra padre. Questo parametro può essere impostato su NULL se non verrà visualizzata alcuna interfaccia utente.

[in] pszPath

Tipo: LPCTSTR

Puntatore a una stringa con terminazione null specificando il percorso completo della directory. Questa stringa è di lunghezza massima di 248 caratteri, incluso il carattere null terminante.

[in, optional] psa

Tipo: const SECURITY_ATTRIBUTES*

Puntatore a una struttura di SECURITY_ATTRIBUTES con l'attributo di sicurezza della directory. Impostare questo parametro su NULL se non devono essere impostati attributi di sicurezza.

Valore restituito

Tipo: int

Restituisce ERROR_SUCCESS se riuscito. Se l'operazione ha esito negativo, è possibile restituire altri codici di errore, inclusi quelli elencati qui. Per i valori non elencati in modo specifico, vedere Codici di errore di sistema.

Codice restituito	Descrizione
ERROR_BAD_PATHNAME	Il parametro pszPath è stato impostato su un percorso relativo.
ERROR_FILENAME_EXCED_RANGE	Il percorso a cui fa riferimento pszPath è troppo lungo.
ERROR_PATH_NOT_FOUND	Il sistema non riesce a trovare il percorso a cui fa riferimento pszPath. Il percorso può contenere una voce non valida.
ERROR_FILE_EXISTS	La directory esiste.
ERROR_ALREADY_EXISTS	La directory esiste.
ERROR_CANCELLED	L'utente ha annullato l'operazione.

Commenti

Questa funzione crea una cartella del file system il cui percorso completo viene fornito da pszPath. Se una o più cartelle intermedie non esistono, vengono create anche. SHCreateDirectoryEx verifica anche che i file siano visibili. Se non sono visibili, aspettarsi uno dei seguenti elementi:

Se hwnd è impostato su un handle di finestra valido, viene visualizzata una finestra di messaggio che avvisa l'utente che potrebbe non essere in grado di accedere ai file. Se l'utente sceglie di non procedere, la funzione restituisce ERROR_CANCELLED.
Se hwnd è impostato su NULL, non viene visualizzata alcuna interfaccia utente e la funzione restituisce ERROR_CANCELLED.

Nota

L'intestazione shlobj_core.h definisce SHCreateDirectoryEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h (includere Shlobj.h, Shlobj_core.h)
Libreria	Shell32.lib
DLL	Shell32.dll (versione 5.0 o successiva)

Vedi anche

SHCreateDirectory

Condividi tramite