Funzione SHCreateDirectoryExW (shlobj_core.h)

Articolo
11/20/2024

[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 SHCreateDirectoryExW(
  [in, optional] HWND                      hwnd,
  [in]           LPCWSTR                   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 che specifica il percorso completo della directory. Questa stringa è di lunghezza massima di 248 caratteri, incluso il carattere Null di terminazione.

[in, optional] psa

Tipo: const SECURITY_ATTRIBUTES*

Puntatore a una struttura SECURITY_ATTRIBUTES con l'attributo di sicurezza della directory. Impostare questo parametro su NULL se non è necessario impostare attributi di sicurezza.

Valore restituito

Tipo: int

Restituisce ERROR_SUCCESS in caso di esito positivo. Se l'operazione non riesce, è 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 punta pszPath è troppo lungo.
ERROR_PATH_NOT_FOUND	Il sistema non riesce a trovare il percorso a cui punta 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.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	shlobj_core.h (includere Shlobj.h, Shlobj_core.h)
libreria	Shell32.lib
dll	Shell32.dll (versione 5.0 o successiva)

Vedere anche

SHCreateDirectory

Condividi tramite