Funzione RemoveDirectory2A (fileapi.h)

Elimina una directory vuota esistente. Questa funzione avrà esito negativo se una parte di lpPathName viene reindirizzata tramite un punto reparse o un collegamento simbolico.

Per eseguire questa operazione come operazione transazionata, utilizzare la funzione RemoveDirectoryTransacted .

Sintassi

BOOL RemoveDirectory2A(
  LPCSTR          lpPathName,
  DIRECTORY_FLAGS DirectoryFlags
);

Parametri

lpPathName

Percorso della directory da rimuovere. Questo percorso deve specificare una directory vuota e il processo chiamante deve avere accesso eliminato alla directory.

Per impostazione predefinita, il nome è limitato a MAX_PATH caratteri. Per estendere questo limite a 32.767 caratteri wide, anteporre "\\?\" al percorso. Per altre informazioni, vedere Denominazione di file, percorsi e spazi dei nomi.

DirectoryFlags

Flag che specificano la modalità di eliminazione della directory. Questo parametro può essere una combinazione dei valori seguenti:

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.

Osservazioni:

La funzione RemoveDirectory2 contrassegna una directory per l'eliminazione alla chiusura. Pertanto, la directory non viene rimossa finché l'ultimo handle della directory non viene chiuso.

Per eliminare in modo ricorsivo i file in una directory, usare la funzione SHFileOperation .

RemoveDirectory2 può essere usato per rimuovere una giunzione di directory. Poiché la directory di destinazione e il relativo contenuto rimarranno accessibili tramite il relativo percorso canonico, la directory di destinazione stessa non è influenzata dalla rimozione di una giunzione destinata a essa. Per questo motivo, quando lpPathName fa riferimento a una giunzione di directory, RemoveDirectory2 rimuoverà il collegamento specificato indipendentemente dal fatto che la directory di destinazione sia vuota o meno. Per altre informazioni sulle giunzioni, vedere Collegamenti rigidi e giunzioni.

L'uso dell'eliminazione POSIX determina l'eliminazione della directory mentre gli handle rimangono aperti. Le chiamate successive a CreateDirectory o CreateDirectory2 per aprire la directory hanno esito negativo con ERROR_FILE_NOT_FOUND.

Questa funzione è supportata dalle tecnologie seguenti:

Requisiti

Vedere anche

CreateDirectory2

Creazione ed Eliminazione di Directory

Funzioni di gestione directory

RemoveDirectoryTransacted