Função SHCreateDirectory (shlobj_core.h)

[SHCreateDirectory está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Cria uma nova pasta do sistema de arquivos.

Sintaxe

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

Parâmetros

[in, optional] hwnd

Digite: HWND

Um identificador de uma janela pai. Esse parâmetro poderá ser definido como NULL se nenhuma interface do usuário for exibida.

[in] pszPath

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho totalmente qualificado do diretório. Essa cadeia de caracteres não deve ter mais do que MAX_PATH caracteres, incluindo o caractere nulo de terminação.

Valor retornado

Tipo: int

Retorna ERROR_SUCCESS se tiver êxito. Se a operação falhar, outros códigos de erro poderão ser retornados, incluindo os listados aqui. Para valores não listados especificamente, consulte Códigos de erro do sistema.

Código de retorno	Descrição
ERROR_BAD_PATHNAME	O parâmetro pszPath foi definido como um caminho relativo.
ERROR_FILENAME_EXCED_RANGE	O caminho apontado por pszPath é muito longo.
ERROR_FILE_EXISTS	O diretório existe.
ERROR_ALREADY_EXISTS	O diretório existe.
ERROR_CANCELLED	O usuário cancelou a operação.

Comentários

Essa função cria uma pasta do sistema de arquivos cujo caminho totalmente qualificado é fornecido pelo pszPath. Se uma ou mais pastas intermediárias não existirem, ela as criará.

Para definir atributos de segurança em uma nova pasta, use SHCreateDirectoryEx.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)

Confira também

SHCreateDirectoryEx