Método Folder.GetDetailsOf

Recupera detalhes sobre um item em uma pasta. Por exemplo, seu tamanho, tipo ou a hora de sua última modificação.

Sintaxe

retVal = Folder.GetDetailsOf(
  vItem,
  iColumn
)

Parâmetros

Vitem

Tipo: Variant

O item para o qual recuperar as informações. Deve ser um objeto FolderItem .

iColumn

Tipo: inteiro

Um valor Integer que especifica as informações a serem recuperadas. As informações disponíveis para um item dependem da pasta na qual ele é exibido. Esse valor corresponde ao número de coluna baseado em zero exibido em uma exibição do Shell. Para um item no sistema de arquivos, esse pode ser um dos seguintes valores:

acima (0)

Recupera o nome do item.

(1)

Recupera o tamanho do item.

(2)

Recupera o tipo do item.

(3)

Recupera a data e a hora em que o item foi modificado pela última vez.

(4)

Recupera os atributos do item.

(-1)

Recupera as informações de dica de informações para o item.

Valor retornado

Tipo: BSTR*

Cadeia de caracteres que contém os detalhes recuperados.

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 implementado, um erro de 0x800A01BD (decimal 445) será gerado.

 

Exemplos

O exemplo a seguir usa GetDetailsOf para recuperar o tipo do arquivo chamado Clock.avi. O uso adequado é mostrado para JScript, VBScript e Visual Basic.

Jscript:

<script language="JScript">
    function fnGetDetailsOfJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var objFolder = new Object;
        
        objFolder = objShell.NameSpace("C:\\WINDOWS");
        if (objFolder != null)
        {
            var objFolderItem = new Object;

            objFolderItem = objFolder.ParseName("clock.avi");
            if (objFolderItem != null)
            {
                var objInfo = new Object;

                objInfo = objFolder.GetDetailsOf(objFolderItem, 2);
            }
        }
    }
</script>

Vbscript:

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

        if (not objFolder is nothing) then
            dim objFolderItem

            set objFolderItem = objFolder.ParseName("clock.avi")

            if (not objFolderItem Is Nothing) then
                dim objInfo
                        
                objInfo = objFolder.GetDetailsOf(objFolderItem, 2)
            end if
            
            set objFolderItem = nothing
        end if
        
        set objFolder = nothing
        set objShell = nothing
    end function
</script>

Visual Basic:

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

    Set objShell = New Shell
    Set objFolder = objShell.NameSpace("C:\WINDOWS")
    
    If (Not objFolder Is Nothing) Then
        Dim objFolderItem As FolderItem
        Set objFolderItem = objFolder.ParseName("clock.avi")
   
        If (Not objFolderItem Is Nothing) Then
            Dim szItem As String
            szItem = objFolder.GetDetailsOf(objFolderItem, 2)
        End If
        
        Set objFolderItem = Nothing
    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	Shlobj_core.h (inclua Shldisp.h)
IDL	Shldisp.idl
DLL	Shell32.dll (versão 4.71 ou posterior)