Folder.GetDetailsOf-Methode

Ruft Details zu einem Element in einem Ordner ab. Beispielsweise die Größe, der Typ oder der Zeitpunkt der letzten Änderung.

Syntax

retVal = Folder.GetDetailsOf(
  vItem,
  iColumn
)

Parameter

vItem

Typ: Variant

Das Element, für das die Informationen abgerufen werden sollen. Hierbei muss es sich um ein FolderItem-Objekt handeln.

iColumn

Typ: Integer

Ein Ganzzahliger Wert, der die abzurufenden Informationen angibt. Die für ein Element verfügbaren Informationen hängen vom Ordner ab, in dem es angezeigt wird. Dieser Wert entspricht der nullbasierten Spaltennummer, die in einer Shellansicht angezeigt wird. Für ein Element im Dateisystem kann dies einer der folgenden Werte sein:

(0)

Ruft den Namen des Elements ab.

(1)

Ruft die Größe des Elements ab.

(2)

Ruft den Typ des Elements ab.

(3)

Ruft das Datum und die Uhrzeit der letzten Änderung des Elements ab.

(4)

Ruft die Attribute des Elements ab.

(-1)

Ruft die Infotippinformationen für das Element ab.

Rückgabewert

Typ: BSTR*

Zeichenfolge, die das abgerufene Detail enthält.

Bemerkungen

Hinweis

Nicht alle Methoden werden für alle Ordner implementiert. Beispielsweise wird die ParseName-Methode nicht für den ordner Systemsteuerung (CSIDL_CONTROLS) implementiert. Wenn Sie versuchen, eine nicht implementierte Methode aufzurufen, wird ein 0x800A01BD -Fehler (dezimal 445) ausgelöst.

 

Beispiele

Im folgenden Beispiel wird GetDetailsOf verwendet, um den Typ der Datei mit dem Namen Clock.avi abzurufen. Die ordnungsgemäße Verwendung wird für JScript, VBScript und Visual Basic angezeigt.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Shlobj_core.h (einschließlich Shldisp.h)
IDL	Shldisp.idl
DLL	Shell32.dll (Version 4.71 oder höher)