Funzione SHCreateDirectory (shlobj_core.h)

Articolo
08/26/2023

[SHCreateDirectory è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Crea una nuova cartella del file system.

Sintassi

int SHCreateDirectory(
  [in, optional] HWND   hwnd,
  [in]           PCWSTR pszPath
);

Parametri

[in, optional] hwnd

Tipo: HWND

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

[in] pszPath

Tipo: PCWSTR

Puntatore a una stringa Unicode con terminazione Null che contiene il percorso completo della directory. Questa stringa non deve contenere più di MAX_PATH caratteri, incluso il carattere Null di terminazione.

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_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.

Per impostare gli attributi di sicurezza in una nuova cartella, usare SHCreateDirectoryEx.

Requisiti


Client minimo supportato	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)
Libreria	Shell32.lib
DLL	Shell32.dll (versione 5.0 o successiva)

Vedi anche

SHCreateDirectoryEx

Condividi tramite