Compartilhar via


Método Folder.NewFolder

Cria uma nova pasta.

Sintaxe

Folder.NewFolder(
  bName,
  [ vOptions ]
)

Parâmetros

bName

Tipo: BSTR

Uma cadeia de caracteres que especifica o nome da nova pasta.

vOptions [opcional]

Tipo: Variant

Esse valor não é usado atualmente.

Valor retornado

Esse método não retorna um valor.

Comentários

Observação

Nem todos os métodos são implementados para todas as pastas. Por exemplo, o método ParseName não é implementado para a pasta Painel de Controle (CSIDL_CONTROLS). Se você tentar chamar um método não simplificado, um erro de 0x800A01BD (decimal 445) será gerado.

 

Exemplos

O exemplo a seguir usa NewFolder para criar a nova pasta C:\TestFolder. O uso adequado é mostrado para JScript, VBScript e Visual Basic.

Jscript:

<script language="JScript">
    function fnFolderObjectNewFolderJ()
    {
        var objShell  = new ActiveXObject("shell.application");
        var objFolder = new Object;
        
        objFolder = objShell.NameSpace("C:\\");
        if (objFolder != null)
        {
            objFolder.NewFolder("TestFolder");
        }
    }
</script>

Vbscript:

<script language="VBScript">
    function fnFolderObjectNewFolderVB()
        dim objShell
        dim objFolder
        
        set objShell = CreateObject("shell.application")
        set objFolder = objShell.NameSpace("C:\")

        if (not objFolder is nothing) then
            objFolder.NewFolder("TestFolder")
        end if

        set objFolder = nothing
        set objShell = nothing
    end function
</script>

Visual Basic:

Private Sub btnNewFolder_Click()
    Dim objShell  As Shell
    Dim objFolder As Folder

    Set objShell = New Shell
    Set objFolder = objShell.NameSpace("C:\")

    If (Not objFolder Is Nothing) Then
        objFolder.NewFolder ("TestFolder")
    End If

    Set objFolder = Nothing
    Set objShell = Nothing
End Sub

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Shldisp.h
IDL
Shldisp.idl
DLL
Shell32.dll (versão 4.71 ou posterior)