100% found this document useful (6 votes)

43 views68 pages

Scripting QTP - CH11 - Shell32

Uploaded by

Rajesh Kumar

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

100% found this document useful (6 votes)

43 views68 pages

Scripting QTP - CH11 - Shell32

Uploaded by

Rajesh Kumar

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

Chapter 11 Scripting Quicktest Professional Page 1

WORKING WITH WINDOWS SHELL32............................................................................. 3

MANAGING DISK QUOTAS ON THE NTFS FILE SYSTEM ....................................................... 4

[Link] OBJECT ........................................................................ 4
[Link] Property ................................................... 5
[Link] Property.................................................................. 5
[Link] Property ................................................................... 5
[Link] Property .................................................................................... 6
[Link] Property ..................................................................... 6
[Link] Property ...................................................................... 6
[Link] Property ............................................................... 6
[Link] Property ............................................................... 7
[Link] Property ........................................................ 7
[Link] Property....................................................................... 7
[Link] Property................................................................ 7
[Link] Method .......................................................................... 8
DISKQUOTACONTROL OBJECT .......................................................................................... 8
[Link] Property .......................................................... 8
[Link] Property ................................................... 9
[Link] Property ................................................... 9
[Link] Property .......................................... 10
[Link] Property.............................................................. 10
[Link] Property....................................................... 10
[Link] Property ..................................................... 11
[Link] Property ..................................................... 11
[Link] Property..................................................................... 11
[Link] Property..................................................... 12
[Link] Method ......................................................................... 12
[Link] Method...................................................................... 12
[Link] Method......................................................................... 13
[Link] Method ................................... 14
[Link] Method ......................................................................... 14
[Link] Method................................................ 15
[Link] Method.............................................. 15
[Link] Method ........................................... 16
[Link] AND SHELL32.FOLDER2 OBJECTS ....................................................... 16
[Link] Property........................................................................ 17
[Link] Property .................................................................................... 17
[Link] Method............................................................................. 18
[Link] Method ........................................................................ 19
[Link] Method .................................................................................... 21
[Link] Method ............................................................................ 21
[Link] Method ........................................................................... 22
[Link] Method ........................................................................... 23
[Link] Property ..................................................................... 24
[Link] Property ................................................................................... 24
[Link] Method ............................................ 25
[Link] Method........................................................................ 25
[Link] OBJECT ....................................................................................... 25

Dani Vainstein Shell32 Page 1 of 68

Chapter 11 Scripting Quicktest Professional Page 2

[Link] Property..................................................................... 25
[Link] Property........................................................................ 26
[Link] Property ................................................................. 26
[Link] Property ................................................................ 27
[Link] Property........................................................................ 27
[Link] Property .......................................................................... 27
[Link] Property.................................................................. 27
[Link] Property ........................................................................... 27
[Link] Property........................................................................... 28
[Link] Property.............................................................................. 28
[Link] Property.............................................................................. 28
[Link] Property ............................................................................ 28
[Link] Method ................................................................... 29
[Link] Method ............................................................................ 30
[Link], SHELL.FOLDERITEMS2, SHELL.FOLDERITEMS3 OBJECTS.......... 32
[Link] Property ......................................................................... 32
[Link] Method ............................................................................. 32
[Link] Method............................................................ 33
[Link] Property........................................................................ 33
[Link] Method .......................................................................... 33
[Link] OBJECT .............................................................................. 35
[Link] Property.................................................................... 35
[Link] Method ....................................................................... 36
[Link] OBJECT ............................................................................ 36
[Link] Property.................................................................. 37
[Link] Method ..................................................................... 37
[Link] INTERFACE AND SHELL OBJECT ............................................ 37
[Link] Property.................................................................................... 37
[Link] Method .................................................................................. 37
[Link] Method........................................................................ 38
[Link] Method ............................................................................ 38
[Link] Method ............................................................................ 39
[Link] Method ........................................................................................... 40
[Link] Method ........................................................................................... 40
[Link] Method ................................................................................ 41
[Link] Method ........................................................................................... 42
[Link] Method ................................................................................. 42
[Link] Method ......................................................................................... 43
[Link] Method ...................................................................................... 44
[Link] Method ....................................................................................... 45
[Link] Method .................................................................... 45
[Link] Method ................................................................................................ 46
[Link] Method ..................................................................................... 47
[Link] Method ............................................................................ 48
[Link] Method.................................................................................... 48
[Link] Method ..................................................................................... 49
[Link] Method ............................................................................................... 49
[Link] Method................................................................................... 50
[Link] Method ..................................................................................... 50
[Link] Method ................................................................................... 50
[Link] Method........................................................................................... 51

Dani Vainstein Shell32 Page 2 of 68

Chapter 11 Scripting Quicktest Professional Page 3

[Link] Method ............................................................................ 52

[Link] Method ......................................................................... 53
[Link] Method .............................................................................. 53
[Link] Method .................................................................................. 54
[Link] Method ................................................................................ 54
[Link] Method................................................................................. 55
[Link] Method ........................................................................... 56
[Link] Method......................................................................................... 56
[Link] Method ............................................................................ 56
[Link] OBJECT ............................................................................. 57
[Link] Property .................................................................. 57
[Link] OBJECT ............................................................................. 57
[Link] Method .................................................. 57
Q&A .................................................................................................................................... 58
HOW TO LIST ITEMS IN THE ADMINISTRATIVE TOOLS FOLDER? ........................................ 58
HOW TO LIST ITEMS IN THE "MY MUSIC" FOLDER? ........................................................ 58
HOW TO RETRIEVE THE PATH TO "COMMON DESKTOP" FOLDER?.................................. 58
HOW TO LIST THE LOCAL COMPUTER INFORMATION? ...................................................... 60
HOW TO ADD A WEB SITE TO THE FAVORITES MENU?....................................................... 60
APPENDIX 14.A – SHELL32 CONSTANTS .............................................................................. 61
QuotaStateConstants Values ..................................................................................... 61
UserNameResolutionConstants Values ..................................................................... 61
QuotaStateConstants Values ..................................................................................... 61
[Link] Values .......................................................................... 61
SHFILEOPSTRUCT Values ..................................................................................... 62
Details Options Values.............................................................................................. 62
[Link] Values............................................................. 63
[Link] Values................................................................... 66
SHCONTF Enumerated Type Values........................................................................ 66
SHGetSetSettings Enumerated Type Values.............................................................. 66
wProcessorArchitectureType SYSTEM_INFO Values .............................................. 66
SHCOLUMNID Values ............................................................................................ 66

Working with Windows Shell32

Microsoft® Windows® Script Host (WSH) is a language-independent scripting host

for Windows Script compatible scripting engines. It brings simple, powerful, and
flexible scripting to the Windows 32-bit platform, allowing you to run scripts from
both the Windows desktop and the command prompt.
Windows Script Host is ideal for non-interactive scripting needs, such as logon
scripting, administrative scripting, and machine automation.
This section describes the Microsoft Windows objects implemented by the Shell32.
Object Description
The DiskQuotaControl object allows a client to manage an NTFS
DIDiskQuotaUser volume's global disk quota settings. This object makes the essential
functionality of the DIDiskQuotaUser interface

DiskQuotaControl The NTFS file system allows an administrator to manage disk usage on a
shared volume by allocating a specified amount of disk space, or quota

Dani Vainstein Shell32 Page 3 of 68

Chapter 11 Scripting Quicktest Professional Page 4

limit, to each user.

The Folder object represents a Shell folder. It contains properties and
Folder
methods that allow you to retrieve information about the folder.
Folder2 The Folder2 object extends the Folder object to support offline folders.
The FolderItem object represents an item in a Shell folder. It contains
FolderItem properties and methods that allow you to retrieve information about the
item.
The FolderItems object represents the collection of items in a Shell
FolderItems folder. It contains properties and methods that allow you to retrieve
information about the collection.
The FolderItems2 object extends the FolderItems object. It supports
FolderItems2
one additional method.
The FolderItems3 object extends the FolderItems2 object. It supports
FolderItems3
an additional method and property.
The FolderItemVerb object represents a single verb available to an
FolderItemVerb
item.

Managing Disk Quotas on the NTFS File System

Disk quotas are an integral part of the NTFS file system. When a file or a folder is
created on a volume formatted with NTFS, that item is assigned an owner (typically
the user who created the item). NTFS obtains the user ID of the file owner and
stores that information in the file or folder's Standard Information attribute. This
attribute tallies all the disk space allocated to the file or folder. NTFS then locates
the quota entry for that user and determines whether the new allocation of disk
space causes the user to exceed the assigned quota. If it does, NTFS then takes
the appropriate steps, which can include logging an entry in the System event log
or preventing the user from creating the file or folder. As the file or folder changes
size, NTFS updates the quota control entry to reflect the total disk space used by
the user.
Disk quotas are not configured on a computer-wide basis, but are instead tied to
individual NTFS volumes. Each drive has separate quota settings, and the actions
you take on one volume do not affect the other volumes.
When managing disk quotas on a computer, the actions you take on one volume do
not affect the other volumes in any way. If you allocate User A 50 MB of disk space
on drive C, this does not also give User A 50 MB of disk space on drives D and E. If
you disable disk quotas on drive D, quotas remain enabled on drives C and E.

[Link] Object

The DiskQuotaControl object allows a client to manage an NTFS volume's global

disk quota settings. This object makes the essential functionality of the
DIDiskQuotaUser interface available to scripting and Microsoft Visual Basic-
based applications.

Dani Vainstein Shell32 Page 4 of 68

Chapter 11 Scripting Quicktest Professional Page 5

Each user on the volume that is managed by the DiskQuotaControl object has a
DIDiskQuotaUser object associated with it. This object allows a client to manage
an individual user's settings. There are several ways to obtain a user's
DIDiskQuotaUser object:
The DIDiskQuotaUser objects for all users with quotas on the volume are
exposed as a collection and can be enumerated. A discussion of how to
enumerate DIDiskQuotaUser objects is found below.
When you add a new user, the AddUser method returns the user's
DIDiskQuotaUser object.
If you have the user's name, the FindUser method returns the user's
DIDiskQuotaUser object.
The DIDiskQuotaUser objects for all users with a quota on the volume are
exposed as a collection. The DiskQuotaControl object exports a standard
enumerator method that allows you to enumerate the collection of
DIDiskQuotaUser objects.

[Link] Property

The AccountContainerName property retrieves the name of the user's

account container.
Data Type
String value that is set to the user's account container name.

For Microsoft Windows NT 4.0 accounts or other accounts without directory

services information, this property contains the domain name.
For accounts with directory services information, this property contains a
canonical name with the terminating object name removed.

[Link] Property

The AccountStatus property retrieves the status of the user's account.

Data Type
Integer – on of the AccountStatus Values in Table 3 on page 61

The property is read-only. The property has no default value.

[Link] Property

The DisplayName property retrieves the status of the user's account.

Data Type
String value that is set to the user's display name.

Dani Vainstein Shell32 Page 5 of 68

Chapter 11 Scripting Quicktest Professional Page 6

This property contains the user's "friendly name." Its value is not
necessarily defined.

[Link] Property

The ID property retrieves an identifier (ID) that uniquely identifies the user.
Data Type
Integer value that uniquely identifies the user's DIDiskQuotaUser object
within a particular DiskQuotaControl process.

The property is read-only. The property has no default value.

[Link] Property

The LogonName property retrieves the user's logon account name.

Data Type
String value that is set to the user's account logon name

The property is read-only. The property has no default value.

[Link] Property

The QuotaLimit property sets or retrieves the user's current quota limit, in
bytes.
Data Type
Integer value that specifies or receives the user's current quota limit, in bytes.

The property is read/write. The property has no default value.

[Link] Property

The QuotaLimitText property sets or retrieves the user's current quota limit,
in bytes.
Data Type
String value that contains the user's current quota limit.

Dani Vainstein Shell32 Page 6 of 68

Chapter 11 Scripting Quicktest Professional Page 7

The property is read-only. The property has no default value.

[Link] Property

The QuotaThreshold property sets or retrieves the user's warning threshold,

in bytes.
Data Type
Integer value that specifies or receives the user's warning threshold. If a user's
disk usage exceeds this value and the LogQuotaThreshold property is set to
TRUE, the system generates an event log entry.

The property is read/write. The property has no default value.

[Link] Property

The QuotaThresholdText property retrieves the user's warning threshold as a

text string.
Data Type
String value that contains the user's warning threshold. If a user's disk usage
exceeds this value and the LogQuotaThreshold property is set to TRUE, the
system generates an event log entry.

The property is read-only. The property has no default value.

[Link] Property

The QuotaUsed property retrieves the user's current disk usage, in bytes.
Data Type
Integer value that is set to the amount of disk space currently in use. If NTFS
file compression is enabled, QuotaUsed reflects the amount of disk space that
the data would require in an uncompressed state.

The property is read-only. The property has no default value.

[Link] Property

The QuotaUsedText property retrieve the user's current disk usage as a text
string.
Data Type

Dani Vainstein Shell32 Page 7 of 68

Chapter 11 Scripting Quicktest Professional Page 8

String value that is set to the amount of disk space currently in use. If NTFS
file compression is enabled, this property reflects the amount of disk space that
the data would require in an uncompressed state.

The property is read-only. The property has no default value.

[Link] Method

The Invalidate method clears the object's cached user information.

Syntax

[Link]()

Return Value
No return value.

This method clears the user information stored in the object's cache. The
next time a request is made for quota-related information, the object
retrieves the information from the NTFS volume and refreshes the cache.

DiskQuotaControl Object

The NTFS file system allows an administrator to manage disk usage on a shared
volume by allocating a specified amount of disk space, or quota limit, to each user.
The DiskQuotaControl object allows an administrator to manage a volume's disk
quota properties. For instance, you can use this object to set the default quota
limit that will be automatically assigned to all new users.
Manage the folder structure to make files easy for users to locate.
Ensure that the proper versions of specific files are installed and updated when
necessary.
Track files and folders, periodically culling files and folders that are no longer
used.
Move files and folders from one location to another as circumstances dictate.
Create and manage shared folders to provide access to files from anywhere
within the organization.

[Link] Property

The DefaultQuotaLimit property sets or retrieves the default quota limit, in

bytes.
Data Type
Integer value that specifies or receives the default quota limit for new users, in
bytes.

Dani Vainstein Shell32 Page 8 of 68

Chapter 11 Scripting Quicktest Professional Page 9

Example
Option Explicit
Dim oShell, oSpFoldersColl
Set oShell = CreateObject("[Link]")
Set oSpFoldersColl = [Link]
MsgBox [Link]

[Link] Property

The DefaultQuotaLimitText property the default quota limit as a text string.

Data Type
String value that contains the default quota limit for new users of the volume.
For example, if the default quota is 10.5 MB, the value of the property is "10.5
MB". If the volume has no default quota, the property is set to "No Limit" or the
localized equivalent.

The property is read-only. The property has no default value.

Example
Option Explicit
Dim oDQCtrl
Dim nDefQuotaLimit, sDefQuotaLimitText
Dim bReadWrite : bReadWrite = False
'--- Creating the MS DiskQuotaControl object from DiskQuotaTypeLibrary
Set oDQCtrl = CreateObject("[Link].1")
[Link] "C:\", bReadWrite
'--- Retrieving the default quota limit (-1 no limit)
nDQLimit = [Link]
sDQLimitText = [Link]
MsgBox nDQLimit & " bytes (" & sDQLimitText & ")", 0, "DefaultQuotaLimit"
'--- Cleaning objects
Set oDQCtrl = Nothing

[Link] Property

The DefaultQuotaThreshold property sets or retrieves the default quota

threshold, in bytes
Data Type
Integer value that is set to the default warning threshold for new users, in

Dani Vainstein Shell32 Page 9 of 68

Chapter 11 Scripting Quicktest Professional Page 10

bytes.

The property is read/write. The property has no default value.

The default quota threshold is applied automatically to new users of the
volume.
If a user's disk usage exceeds this value and the LogQuotaThreshold
property is set to TRUE, the system generates an event log entry. For
example, if the default threshold is 10.0 MB, the value of the property is
"10.0 MB". If the volume has no default threshold, the property is set to "No
Limit" or the localized equivalent.

[Link] Property

The DefaultQuotaThresholdText property retrieves the default quota

threshold as a text string.
Data Type
String value that contains the default quota threshold for the volume.

The property is read-only. The property has no default value.

[Link] Property

The LogQuotaLimit property sets or retrieves a Boolean value that indicates

whether a system event log entry will be made when a user exceeds his or her
assigned quota limit.
Data Type
This property is set to TRUE if a system event log entry is made when the user
exceeds his or her quota limit, or FALSE otherwise.

The property has no default value.

[Link] Property

The LogQuotaThreshold property sets or retrieves a Boolean value that

Dani Vainstein Shell32 Page 10 of 68

Chapter 11 Scripting Quicktest Professional Page 11

indicates whether a system event log entry will be made when a user exceeds
his or her assigned quota threshold.
Data Type
This property is set to TRUE if a system event log entry is made when the user
exceeds his or her quota warning threshold, or FALSE otherwise.

The property has no default value.

[Link] Property

The QuotaFileIncomplete property retrieves a Boolean value that indicates

whether the quota file for the volume is complete.
Data Type
This property is set to TRUE if the quota file is incomplete, or FALSE otherwise.

The property is read-only. The property has no default value.

[Link] Property

The QuotaFileRebuilding property retrieves a Boolean value that indicates

whether the quota file for the volume is currently being rebuilt.
Data Type
This property is set to TRUE if the quota file is being rebuilt, or FALSE
otherwise.

The property is read-only. The property has no default value.

The quota file is automatically rebuilt when quotas are enabled on the
system or when one or more user entries are marked for deletion.

[Link] Property

The QuotaState property sets or retrieves the state of the volume's disk
quotas.
Data Type
Integer, The property can be set to one of the QuotaStateConstants defined in
Table 1 on page 61

The property is read/write. The property has no default value

Dani Vainstein Shell32 Page 11 of 68

Chapter 11 Scripting Quicktest Professional Page 12

[Link] Property

The UserNameResolution property sets or retrieves a value that controls how

user Security IDentifier (SID) is resolved to user names.
Data Type
Integer, The property can be set to one of the UserNameResolutionConstants
defined in Table 2 on page 71

The property is read/write. The property has no default value.

This property affects the enumeration of DIDiskQuotaUser objects, and
the AddUser and FindUser methods.

[Link] Method

The AddUser method assigns a nondefault disk quota to a new user.

Syntax

[Link] (sLogonName)

Arguments
Parameter Description
Required. String value that contains the user's logon name. Use the
sLogonName UserNameResolution property to specify how the name is to be
resolved.

Return Value
No return value.

The NTFS file system automatically creates a user quota entry when a user
first writes to the volume.
Entries that are created in this way are assigned the default warning
threshold and hard quota limit values for the volume.
This method allows you to create a user quota entry before a user writes
information to the volume. It returns a DIDiskQuotaUser object that can
be used to assign a warning threshold or quota limit value that differs from
the default settings for the volume.
If the user already exists, no new entry is created. The method returns the
DIDiskQuotaUser object associated with the existing entry.

[Link] Method

The AddUser method deletes a user from the volume.

Dani Vainstein Shell32 Page 12 of 68

Chapter 11 Scripting Quicktest Professional Page 13

Syntax

[Link] (oUser)

Arguments
Parameter Description
Required. Object expression that evaluates to the user's
oUser
DIDiskQuotaUser object.

Return Value
No return value.

This method fails if the user owns any storage on the volume. Before you
delete a user from a volume, all storage for that user must be deleted, be
moved to another volume, or have its ownership transferred to another
[Link] default settings for the volume.

[Link] Method

The FindUser method finds a user's entry, by name, in the volume's quota file.
Syntax

[Link] (sLogonName)

Arguments
Parameter Description
sLogonName Required. String value that contains the user's logon name.

This method returns a DIDiskQuotaUser object even if there is no entry for

the user in the quota file. The returned user object has warning threshold
and hard quota limits set to the volume's default values.
The string returned from TranslateLogonNameToSID may be passed in
place of the sLogonName parameter.
When FindUser receives a SID string it uses the corresponding SID for
direct lookup of the user's quota record on the volume. This bypasses the
SID-name cache. In cases where FindUser fails due to a mismatch in
format (SAM-compatible vs. UPN) of the logon name provided and the
logon name cached, the logon name can be translated to a SID string using
TranslateLogonNameToSID then passed again to FindUser.
Example
the logon name can be translated to a SID string using
TranslateLogonNameToSID then passed again to FindUser.
Function Find(ByVal oDQC, ByVal sName)
On Error Resume Next

Dani Vainstein Shell32 Page 13 of 68

Chapter 11 Scripting Quicktest Professional Page 14

Set Find = [Link](sName)

If [Link] <> 0 Then
[Link]
Set Find = [Link]([Link](sName))
End If
End Function
Set oDQC = Nothing

[Link]
Method

The GiveUserNameResolutionPriority method places the specified user

object next in line for name resolution.
Syntax

[Link] (oUser)

Arguments
Parameter Description
Required. Object expression that evaluates to the user's
oUser
DIDiskQuotaUser object.

Return Value
No return value.

If asynchronous name resolution is enabled, user objects are placed in a

queue. By default, they are serviced in the order they are placed in the
queue. The GiveUserNameResolutionPriority method moves an object to
the front of the queue so that it is next in line to be serviced.
Use the UserNameResolution property to enable asynchronous name
resolution.

[Link] Method

The GiveUserNameResolutionPriority method places the specified user

object next in line for name resolution.
Syntax

[Link] (sPath, bReadWrite)

Arguments
Parameter Description
Required. String value that contains the fully qualified path of the volume
sPath
to be initialized.
bReadWrite Required. Boolean value that specifies how the volume is to be opened.

Dani Vainstein Shell32 Page 14 of 68

Chapter 11 Scripting Quicktest Professional Page 15

Set bReadWrite to TRUE for read/write access or FALSE for read-only

access.

Return Value
No return value.

[Link] Method

The InvalidateSidNameCache method invalidates the security identifier (ID)

user name cache.
Syntax

[Link]

Return Value
No return value.

Users' names and associated security IDs are stored in a cache. You can
clear this cache by calling InvalidateSidNameCache.
If you subsequently create a new user object, the information will have to be
obtained from the domain controller, and the cache will have to be
reestablished.

[Link] Method

The ShutdownNameResolution method shuts down the user name resolution

thread.
Syntax

[Link]

Return Value
No return value.

The security identifier (SID) name resolver translates SID to user names on
a background thread.
This thread is shut down automatically when the associated quota control
object is destroyed. However, there are some cases when the thread is no
longer needed, but the object is not yet ready to be destroyed.
A typical example is when no further processing is taking place, but clients
are still holding references to the object.
The ShutdownNameResolution method allows you to terminate the
resolver thread and free the associated resources without destroying the
quota control object.
When you shut down the resolver thread, asynchronous name resolution

Dani Vainstein Shell32 Page 15 of 68

Chapter 11 Scripting Quicktest Professional Page 16

immediately stops. If calls are subsequently made to methods such as

AddUser or FindUser, the quota object might re-create the resolver
thread.

[Link] Method

The TranslateLogonNameToSID method places the specified user object next

in line for name resolution.
Syntax

[Link] (logonname)

Arguments
Parameter Description
logonname Required. String value that specifies the user's logon name.

Return Value
No return value.

The returned SID string can be passed to the FindUser method in place of
a logon name.
When a call to the FindUser( logonname) method fails, it could be due to a
mismatch between the form (Security Account Manager [SAM]
compatible vs. User Principal Name [UPN]) of the logon name provided
and the form stored in the SID-name cache. In such cases, the logon name
can be converted to a SID and the call to FindUser repeated. FindUser
recognizes a SID string and will bypass the SID-name cache lookup.
Name-to-SID translation can be a slow process when compared to lookups
in the SID-name cache. Therefore, it is recommended that FindUser first
be called with a logon name.
Example
the logon name can be translated to a SID string using
TranslateLogonNameToSID then passed again to FindUser.
Function Find(ByVal oDQC, ByVal sName)
On Error Resume Next
Set Find = [Link](sName)
If [Link] <> 0 Then
[Link]
Set Find = [Link]([Link](sName))
End If
End Function
Set oDQC = Nothing

[Link] and Shell32.Folder2 Objects

The Folder object represents a Shell folder. It contains properties and methods

Dani Vainstein Shell32 Page 16 of 68

Chapter 11 Scripting Quicktest Professional Page 17

that allow you to retrieve information about the folder.

The Folder2 object extends the Folder object to support offline folders.

[Link] Property

The ParentFolder property contains the parent Folder object.

Data Type
An object reference to the ParentFolder object.

Note Not all methods are implemented for all folders. For example, the
ParseName method is not implemented for the Control Panel folder
(CSIDL_CONTROLS). If you attempt to call an unimplemented method, a
0x800A01BD (decimal 445) error is raised.
Example
The following code implements the ParentFolder property to retrieve the
Folder object.
Option Explicit
Private Const ssfPROGRAMS = 2
Dim oShell32, oFolder, oParentFolder
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](ssfPROGRAMS)
'--- Checking Folder object validation
If (Not oFolder Is Nothing) Then
'--- Retrieving the parent folder object
Set oParentFolder = [Link] '--- usually "Start Menu".
Msgbox [Link]
End If
Set oParentFolder = Nothing : Set oFolder = Nothing : Set oShell32 = Nothing

[Link] Property

The ParentFolder property contains the title of the folder.

Data Type
An object reference to the ParentFolder object.

Dani Vainstein Shell32 Page 17 of 68

Chapter 11 Scripting Quicktest Professional Page 18

user's program groups (usually "Programs").

Option Explicit
Private Const ssfPROGRAMS = 2
Dim oShell32, oFolder
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](ssfPROGRAMS)
'--- Checking Folder object validation
If (Not oFolder Is Nothing) Then
'--- Retrieving the folder title
Msgbox [Link]
End If
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

[Link] Method

The CopyHere method copies an item or items to a folder.

Syntax

[Link](vItem, vOptions)

Arguments
Parameter Description
Required. Specifies the item or items to copy. This can be a string that
vItem
represents a file name, a FolderItem object, or a FolderItems object.
Optional. Specifies options for the copy operation. This value can be zero
vOptions or a combination of the of the SHFILEOPSTRUCT structure values
described in Table 5 on page 62

Return Value
No return value.

Dani Vainstein Shell32 Page 18 of 68

Chapter 11 Scripting Quicktest Professional Page 19

Option Explicit
Private Const FOF_FILESONLY = 128
Private Const FOF_NOCONFIRMATION = 16
Dim oShell32, oFolder
'--- Creating the shell application file
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link]("C:\Windows")
If Not oFolder Is Nothing Then
'--- Copy to folder all files under temp with
'--- flag for use regular expression and
'--- flag to avoid confirmation dialog
[Link] "C:\temp\*.*", FILESONLY + FOF_NOCONFIRMATION
End If
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

[Link] Method

Figure 1 - Details options

The GetDetailsOf method retrieves details about an item in a folder.

For example, its size, type, or the time of its last modification.
Syntax

[Link](vItem, iColumn)

Arguments
Parameter Description

Dani Vainstein Shell32 Page 19 of 68

Chapter 11 Scripting Quicktest Professional Page 20

Required. Specifies the item or items to copy. This can be a string that
vItem
represents a file name, a FolderItem object, or a FolderItems object.
Required. An Integer value that specifies the information to be retrieved.
The information available for an item depends on the folder in which it is
iColumn displayed. This value corresponds to the zero-based column number that
is displayed in a Shell view. For an item in the file system, this can be one
of the Details Options Values in Table 6 on page 63

Return Value
String containing the retrieved detail.

Not all methods are implemented for all folders. For example, the
ParseName method is not implemented for the Control Panel folder
(CSIDL_CONTROLS). If you attempt to call an unimplemented method, a
0x800A01BD (decimal 445) error is raised.
Example
The following example uses GetDetailsOf to retrieve the type of the file named
[Link].
Option Explicit
Private Const colInfoTip = -1
Dim oShell32, oFolder, oFolderItem
Dim sInfo
'--- Creating the shell application file
Set oShell32 = CreateObject("[Link]")
'--- Retrieving a folder object using the namespace method
Set oFolder = [Link]("C:\Windows")
'--- Checking Folder validation
If not oFolder is nothing then
'--- Retrieving the file item object
Set oFolderItem = [Link]("[Link]")
'--- Checking file item validation
If (Not oFolderItem Is Nothing) then
'--- Retrieving the info tip information for the item.
sInfo = [Link](oFolderItem, colInfoTip)
MsgBox sInfo, 0, "Info Tip Information"
End if
Set oFolderItem = Nothing
End if
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing : Set oFolderItem = Nothing

Dani Vainstein Shell32 Page 20 of 68

Chapter 11 Scripting Quicktest Professional Page 21

[Link] Method

The Items method retrieves a FolderItems object that represents the

collection of items in the folder.
Syntax

[Link]()

Not all methods are implemented for all folders. For example, the
ParseName method is not implemented for the Control Panel folder
(CSIDL_CONTROLS). If you attempt to call an unimplemented method, a
0x800A01BD (decimal 445) error is raised.
Example
The following example uses Items to determine the number of items in the
C:\Program Files folder.
Option Explicit
Dim oShell32, oFolder, oFolderItem
Dim nCount
'--- Creating the shell application file
Set oShell32 = CreateObject("[Link]")
'--- Retrieving a folder object using the namespace method
Set oFolder = [Link](CSIDL_PROGRAM_FILES)
'--- Checking Folder validation
If not oFolder is nothing then
'--- Retrieving all files items object
Set oFolderItems = [Link]
'--- Checking file item validation
If (Not oFolderItems Is Nothing) then
'--- Retrieving the count iformation.
nCount = [Link]
MsgBox nCount, 0, "Number of items under C:\Windows"
End if
Set oFolderItems = Nothing
End if
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

[Link] Method
Description

Dani Vainstein Shell32 Page 21 of 68

Chapter 11 Scripting Quicktest Professional Page 22

The MoveHere method copies an item or items to a folder.

Syntax

[Link](vItem, vOptions)

Not all methods are implemented for all folders. For example, the
ParseName method is not implemented for the Control Panel folder
(CSIDL_CONTROLS). If you attempt to call an unimplemented method, a
0x800A01BD (decimal 445) error is raised.
Example
The following example uses MoveHere to move the all the files in MyTemp from
the root directory of the C:\ drive to the C:\MyTempFolder folder, with a
progress bar.
Option Explicit
Private Const FOF_FILESONLY = 128
Private Const FOF_SIMPLEPROGRESS = 256
Dim sPath
Dim oShell32, oFolder
'--- Creating the shell application file
Set oShell32 = CreateObject("[Link]")
'--- Retrieving a folder object using the namespace method
Set oFolder = [Link]("C:\MyTempFolder")
'--- Checking Folder validation
If Not oFolder Is Nothing Then
'--- Moving to oFolder
sPath = "C:\Program Files\Mercury Interactive\MyTemp\*.*"
[Link] sPath, FOF_FILESONLY + FOF_SIMPLEPROGRESS
End If
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

[Link] Method

The NewFolder method creates a new folder.

Syntax

[Link](sName, vOptions)

Arguments

Dani Vainstein Shell32 Page 22 of 68

Chapter 11 Scripting Quicktest Professional Page 23

Parameter Description
sName Required. A string that specifies the name of the new folder.
vOptions Optional. This value is not currently used.

Return Value
No return value.

[Link] Method

The ParseName method creates and returns a FolderItem object that

represents a specified item.
Syntax

[Link](sName)

Arguments
Parameter Description
sName Required. A string that specifies the name of the item.

Return Value
An object reference to the FolderItem object.

ParseName should not be used for virtual folders such as My Documents.

Not all methods are implemented for all folders. For example, the
ParseName method is not implemented for the Control Panel folder

Dani Vainstein Shell32 Page 23 of 68

Chapter 11 Scripting Quicktest Professional Page 24

(CSIDL_CONTROLS). If you attempt to call an unimplemented method, a

0x800A01BD (decimal 445) error is raised.

[Link] Property
Description
The OfflineStatus property contains Contains the offline status of the folder.
Data Type
Integer that is set to one of the [Link] values described in
Table 4 on page 61

The property is read-only. The property has no default value.

Offline Files must be enabled through Folder Options for OfflineStatus to
work correctly. If the Offline Files option is not enabled, the property returns
OFS_INACTIVE.
Example
The following example shows the proper use of OfflineStatus
Option Explicit
Dim oShell32, oFolder
Dim nReturn
'--- Creating the shell application object
Set oShell32 = CreateObject("[Link]")
'--- Retrieving a folder object using the namespace method
Set oFolder = [Link]("\\server\share\folder")
'--- Checking Folder validation
If Not oFolder Is Nothing then
nReturn = [Link]
End if
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

[Link] Property

The Self property contains Contains the offline status of the folder.
Data Type
Integer that is set to one of the [Link] values described in
Table 4 on page 61

The property is read-only. The property has no default value.

Dani Vainstein Shell32 Page 24 of 68

Chapter 11 Scripting Quicktest Professional Page 25

C:\Windows folder.
Option Explicit
Private Const CSIDL_WINDOWS = 36
Dim oShell32, oFolder, oFolderItem
'--- Creating the shell application file
Set oShell32 = CreateObject("[Link]")
'--- Retrieving a folder object using the namespace method
Set oFolder = [Link](CSIDL_WINDOWS)
'--- Checking Folder validation
If Not oFolder Is Nothing Then
Set oFolderItem = [Link]
If (Not oFolderItem Is Nothing) Then
'Add code here.
End if
End if
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing : Set oFolderItem = Nothing

[Link] Method

The DismissedWebViewBarricade method Specifies that the Web view

barricade has been dismissed by the user.
Syntax

[Link]()

Call this method after the Web view barricade is dismissed by the user

[Link] Method
Description
The Synchronize method sychronizes all offline files.
Syntax

[Link] ()

[Link] Object

The FolderItem object represents an item in a Shell folder. It contains properties

and methods that allow you to retrieve information about the item.

[Link] Property

The GetFolder property contains the item's Folder object, If the item is a
folder.

Dani Vainstein Shell32 Page 25 of 68

Chapter 11 Scripting Quicktest Professional Page 26

The property is read-only. The property has no default value.

Example
The following example uses GetFolder to retrieve the Folder object for the
System32 folder.
Option Explicit
Private Const CSIDL_WINDOWS = 36
Dim oShell32, oFolder, oFolderItem
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](CSIDL_WINDOWS)
'--- Checking Folder object validation
If (Not oFolder Is Nothing) Then
'--- Retrieve the System32 folder item
Set oFolderItem = [Link]("system32")
'--- Validation...
If (Not oFolderItem Is Nothing) Then
'--- Set Folder item to folder to activate folder methods
Set oFolder = [Link]
If (Not oFolder is Nothing) Then
'--- Add code here
End If
Set oFolder = Nothing
End if
Set oFolderItem = Nothing
End If
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

[Link] Property

The GetLink property contains the item's ShellLinkObject object, If the item
is a shortcut

The property is read-only. The property has no default value.

[Link] Property

The IsBrowsable property indicates if the item can be browsed.

The property is read-only. The property has no default value.

Receives true if the item can be browsed or false if not.

Dani Vainstein Shell32 Page 26 of 68

Chapter 11 Scripting Quicktest Professional Page 27

[Link] Property

The IsFileSystem property indicates if the item is part of the file system.

The property is read-only. The property has no default value.

Receives true if the item is part of the file system or false if not.

[Link] Property

The IsFolder property indicates if the item is a folder.

Data Type
Boolean that receives true if the item is a folder or false if not.

The property is read-only. The property has no default value.

[Link] Property

The IsLink property indicates if the item is a shortcut.

Data Type
Boolean that receives true if the item is a shortcut or false if not.

The property is read-only. The property has no default value.

[Link] Property

The ModifyDate property sets or retrieves the date and time that a file was
last modified. ModifyDate can be used to retrieve the data and time that a
folder was last modified, but cannot set it.
Data Type
Date that specifies or receives the date and time that the item was last
modified.

The property is read/write. The property has no default value.

[Link] Property

The Name property sets or retrieves the item's name.

Dani Vainstein Shell32 Page 27 of 68

Chapter 11 Scripting Quicktest Professional Page 28

Data Type
String that specifies or receives the item's name.

The property is read/write. The property has no default value.

[Link] Property

The Parent property contains the item's parent object.

Data Type
Object that receives the Parent object.

The property is read-only. The property has no default value.

[Link] Property

The Path property contains the item's full path and name.
Data Type
String that receives the item's full path and name.

The property is read-only. The property has no default value.

[Link] Property

The Size property contains the item's size, in bytes.

Data Type
Integer that receives the item's size.

The property is read-only. The property has no default value.

[Link] Property

The Type property contains a string representation of the item's type.

Data Type
String that receives the item's type.

The property is read-only. The property has no default value.

Dani Vainstein Shell32 Page 28 of 68

Chapter 11 Scripting Quicktest Professional Page 29

[Link] Method

The InvokeVerb method executes a verb on the item.

Syntax

[Link] (vVerb)

Arguments
Parameter Description
Optional. A string that specifies the verb to be executed. It must be one
vVerb of the values returned by the item's [Link] property. If
no verb is specified, the default verb will be invoked.

Return Value
No return value.

A verb is a string used to specify a particular action that an item supports.

Invoking a verb is equivalent to selecting a command from an item's
shortcut menu.
Typically, invoking a verb launches a related application. For example,
invoking the "open" verb on a .txt file opens the file with a text editor,
usually Microsoft Notepad.
The FolderItemVerbs object represents the collection of verbs associated
with the item.
The default verb may vary for different items, but it is typically "open".
Example1
The following example uses InvokeVerb to invoke the default verb ("open" in
this case) on the Windows folder.
Option Explicit
Private Const CSIDL_WINDOWS = 36
Dim oShell32, oFolder, oFolderItem
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](CSIDL_WINDOWS)
'--- Checking Folder object validation
If (Not oFolder Is Nothing) Then
'--- Retrieve the FolderItem object
Set oFolderItem = [Link]
'--- Validation...
If (Not oFolderItem Is Nothing) Then
'--- Invoking the default verb usually 'open'
[Link]()
End if
Set oFolderItem = Nothing
End If
'--- Cleaning objects

Dani Vainstein Shell32 Page 29 of 68

Chapter 11 Scripting Quicktest Professional Page 30

Set oFolder = Nothing : Set oShell32 = Nothing

Example2
The following example uses InvokeVerb to invoke the verb "properties".
Option Explicit
Private Const CSIDL_WINDOWS = 36
Dim oShell32, oFolder, oFolderItem
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](CSIDL_WINDOWS)
'--- Checking Folder object validation
If (Not oFolder Is Nothing) Then
'--- Retrieve the FolderItem object
Set oFolderItem = [Link]
'--- Validation...
If (Not oFolderItem Is Nothing) Then
'--- Invoking the verb 'Properties'
[Link]("Properties")
End if
Set oFolderItem = nothing
End If
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

[Link] Method
Description
The Verbs method retrieves the item's FolderItemVerbs object. This object is

Dani Vainstein Shell32 Page 30 of 68

Chapter 11 Scripting Quicktest Professional Page 31

the collection of verbs that can be executed on the item.

Syntax

[Link]()

Return Value
An object reference to the FolderItemVerbs object.

A verb is a string used to specify a particular action that an item supports.

Invoking a verb is equivalent to selecting a command from an item's
shortcut menu.
Typically, invoking a verb launches a related application. For example,
invoking the "open" verb on a .txt file opens the file with a text editor,
usually Microsoft Notepad.
The FolderItemVerbs object represents the collection of verbs associated
with the item.
The default verb may vary for different items, but it is typically "open".
Example
The following example uses Verbs to retrieve the FolderItemVerbs object
representing the set of verbs that can be executed on the Windows folder.
Option Explicit
Private Const CSIDL_WINDOWS = 36
Dim oShell32, oFolder, oFolderItem, oFolderItemVerbs, oFolderItemVerb
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](CSIDL_WINDOWS)
'--- Checking Folder object validation
If (Not oFolder Is Nothing) then
'--- Retrieve the FolderItem object
Set oFolderItem = [Link]("[Link]")
'--- Validation...
If (Not oFolderItem Is Nothing) Then
'--- invoking the context menu properties of the file
Set oFolderItemVerbs = [Link]
'--- Looping the collection of oFolderItemVerbs
For Each oFolderItemVerb In oFolderItemVerbs
sVerbList = sVerbList & [Link] & vbNewLine
Next
'--- Cleaning objects
Set oFolderItemVerb = Nothing : Set oFolderItemVerbs = Nothing
Msgbox sVerbList,0, "current [Link] verbs list"
End if
Set oFolderItem = Nothing
End If
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

Dani Vainstein Shell32 Page 31 of 68

Chapter 11 Scripting Quicktest Professional Page 32

[Link], Shell.FolderItems2, Shell.FolderItems3

Objects

The FolderItems object represents the collection of items in a Shell folder. It

contains properties and methods that allow you to retrieve information about the
collection.

[Link] Property

The Count property contains the number of items in the collection.

Data Type
An Integer that contains a value for the Count property.

The property is read-only. The property has no default value.

[Link] Method

The Item method retrieves the FolderItem object for a specified item in the
collection.
Syntax

[Link](nIndex)

Arguments
Parameter Description
Optional. Specifies the zero-based index of the item to retrieve. This
nIndex
value must be less than the value of the Count property.

Dani Vainstein Shell32 Page 32 of 68

Chapter 11 Scripting Quicktest Professional Page 33

Return Value
An object reference to the FolderItem object.

[Link] Method
Description
The InvokeVerbEx method executes a verb on a collection of FolderItem
objects. This method is an extension of the InvokeVerb method, allowing
additional control of the operation through a set of flags.
Syntax

[Link] (vVerb, vArgs)

Arguments
Parameter Description
Optional. Variant with the verb string that corresponds to the command
vVerb
to be executed. If no verb is specified, the default verb is executed.
Optional. Variant that consists of a string with one or more arguments to
vArgs the command specified by vVerb. The format of this string depends on
the particular verb.

Return Value
No return value.

A verb is a string used to specify a particular action associated with an item

or collection of items. Typically, calling a verb launches a related
application.
For example, calling the open verb on a .txt file normally opens the file with
a text editor, usually Microsoft Notepad.

[Link] Property

The Verbs property retrieves the list of verbs common to all the folder items.
Data Type
Collection of FolderItemVerbs to be returned.

The property is read-only. The property has no default value.

[Link] Method

The Filter method sets a wildcard filter to apply to the items returned.
Syntax

Dani Vainstein Shell32 Page 33 of 68

Chapter 11 Scripting Quicktest Professional Page 34

[Link] (grfFlags, bstrFilter)

Arguments
Parameter Description
Required. This parameter can be one of the flags listed in SHCONTF
grfFlags
Enumerated Type Values.
bstrFilter Required. Contains a filter string.

Return Value
No return value.

For a list SHCONTF Enumerated Type Values of see Table 9 on page 66

Example
The following example uses Item to retrieve the FolderItem object
representing the Windows folder and filtering the content
Option Explicit
Private Const CSIDL_WINDOWS = 36
Private Const SHCONTF_NONFOLDERS = 64
Dim oShell32, oFolder, oFolderItem, oFolderItems
Dim nCount
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](CSIDL_WINDOWS)
'--- Checking Folder object validation
If (Not oFolder Is Nothing) then
'--- Retrieve the FolderItems collection object
Set oFolderItems = [Link]()
'--- Validation...
If (Not oFolderItems Is Nothing) Then
nCount = [Link]
Msgbox "Items before Filter = " & nCount, 0, "Filter Method"
[Link] SHCONTF_NONFOLDERS, "*.exe"
nCount = [Link]
Msgbox "Items after Filter = " & nCount, 0, "Filter Method"
End if
Set oFolderItem = Nothing : Set oFolderItems = Nothing
End If
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

Dani Vainstein Shell32 Page 34 of 68

Chapter 11 Scripting Quicktest Professional Page 35

[Link] Object

The FolderItemVerb object represents a single verb available to an item. The

object contains properties and methods that allow you to retrieve information
about the verb.
Each verb corresponds to the command that would be used to launch the
application from a console window. The open verb is a good example, as it is
commonly supported. For .exe files, open simply launches the application.
However, it is more commonly used to launch an application that operates on a
particular file. For instance, .txt files can be opened by Microsoft WordPad.
The open verb for a .txt file would thus correspond to something like the following
command:
"C:\Program Files\Windows NT\Accessories\[Link]" "%1"
When you use ShellExecute or ShellExecuteEx to open a .txt file, [Link] is
launched with the specified file as its argument. Some commands can have
additional arguments, such as flags, that can be added as needed to launch the
application properly. For further discussion of shortcut menus and verbs, see

[Link] Property

The Name property contains the verb's name.

Data Type
String that receives the Name property.

The property is read-only. The property has no default value.

Example
The following example uses Name property to retrieve the name of the first
item in the collection of verbs to which the user's Program folder responds.
Option Explicit
Private Const CSIDL_PROGRAMS = 2
Dim oShell32, oFolder, oVerbs, oVerb
Dim sVerbList
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](CSIDL_WINDOWS)
'--- Checking Folder object validation
If (Not oFolder Is Nothing) then
'--- Retrieve the Verbs collection object
Set oVerbs = [Link]
If (Not oVerbs Is Nothing) then
'--- This method implemets the For each loop
For Each oVerb in oVerbs
sVerbsList = sVerbsList & [Link] & vbNewLine
Next
Msgbox sVerbsList, 0, "Verbs List"

Dani Vainstein Shell32 Page 35 of 68

Chapter 11 Scripting Quicktest Professional Page 36

'--- Resetting variable

sVerbsList = Empty
'--- This method implemets the For i to Count loop
For i = 0 To [Link] - 1
sVerbsList = sVerbsList & [Link](i).Name & vbNewLine
Next
Msgbox sVerbsList, 0, "Verbs List"
End If
Set oVerb = Nothing : Set oVerbs = Nothing
End If
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

[Link] Method

The DoIt method Executes a verb on the FolderItem associated with the verb.
Syntax

[Link] ()

Return Value
No return value.

[Link] Object

The FolderItemVerbs object represents the collection of verbs for an item in a

Shell folder. It contains properties and methods that allow you to retrieve
information about the collection.
The verbs available for an object are essentially the items that you find on an
object's shortcut menu. To find which verbs are available, look in the registry
under
HKEY_CLASSES_ROOT\CLSID\{object_clsid}\Shell\verb
where object_clsid is the class identifier (CLSID) of the object, and verb is the
name of the available verb. The verb\command subkey contains the data
indicating what happens when that verb is invoked.
Commonly available verbs include:
Verb Description
edit Launches an editor and opens the document for editing.
find Initiates a search starting from the specified directory.
open If this file is not an executable file, its associated application is launched.
print Prints the document file.
properties Displays the object's properties.

Dani Vainstein Shell32 Page 36 of 68

Chapter 11 Scripting Quicktest Professional Page 37

[Link] Property
Description
The Count property contains the number of items in the collection.
Data Type
Integer that receives the Count property.

The property is read-only. The property has no default value.

[Link] Method

The Item method retrieves the FolderItemVerb object for a specified item in
the collection.
Syntax

[Link] (nIndex)

Arguments
Parameter Description
Required. Specifies the zero-based index of the item to retrieve. This
nIndex
value must be less than the value of the Count property

Return Value
Object that receives the FolderItemVerb object.

[Link] Interface and Shell Object

The Shell object represents the objects in the Shell. Methods are provided to
control the Shell and to execute commands within the Shell. There are also
methods to obtain other Shell-related objects.

[Link] Property

The Parent property contains the object's parent object.

Data Type
Object that receives the Parent object.

The property is read-only. The property has no default value.

[Link] Method
Description

Dani Vainstein Shell32 Page 37 of 68

Chapter 11 Scripting Quicktest Professional Page 38

The AddToRecent method determines if the current user can start and stop the
named service.
Syntax

[Link] (varFile, bstrCategory)

Arguments
Parameter Description
Required. Variant that specifies the file to add to the list of recently used
varFile
documents.
Optional. String that contains the name of the category in which to place
bstrCategory
the file.

Return Value
No return value..

[Link] Method

The CanStartStopService method determines if the current user can start and
stop the named service.
Syntax

[Link] (sServiceName)

Arguments
Parameter Description
sServiceName Required. String that contains the name of the service.

Return Value
Returns True if the user can start and stop the service, or False otherwise.
Example
The following example shows the proper usage of CanStartStopService inside a
public function
Public Function fCanStartStopService(ByVal sServiceName)
Dim oShell32
Set oShell32 = CreateObject("[Link]")
fCanStartStopService = [Link](sServiceName)
Set oShell32 = nothing
End function

[Link] Method
Description
The CascadeWindows method Cascades all of the windows on the desktop.
This method has the same effect as right-clicking the taskbar and selecting
Cascade Windows.

Dani Vainstein Shell32 Page 38 of 68

Chapter 11 Scripting Quicktest Professional Page 39

Syntax

[Link] ()

Return Value
No return value.

Figure 2 - Cascade Windows

[Link] Method

The ControlPanelItem method runs the specified Control Panel application.

If the application is already open, it will activate the running instance.
Syntax

[Link] (sDir)

Arguments
Parameter Description
Required. Specifies the Control Panel application's file name. All Control
sDir
Panel applications have the .cpl extension.

Return Value
No return value.

Example
The following example uses ControlPanelItem to run the Control Panel's
Display Properties item.
Option Explicit
Dim oShell32
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
[Link]("[Link]")
'--- Cleaning objects
Set oShell32 = Nothing

Dani Vainstein Shell32 Page 39 of 68

Chapter 11 Scripting Quicktest Professional Page 40

Figure 3 - Display Properties item

[Link] Method

The EjectPC method ejects the computer from its docking station. This is the
same as clicking the Start menu and selecting Eject PC, if your computer
supports this command.
Syntax

[Link]()

Return Value
No return value.

[Link] Method

The Explore method opens a specified folder in a Microsoft Windows Explorer

window.
Syntax

[Link](vDir)

Arguments
Parameter Description

vDir Required. Specifies the folder to be displayed. This can be a string that
specifies the path of the folder or one of the ShellSpecialFolderConstants

Dani Vainstein Shell32 Page 40 of 68

Chapter 11 Scripting Quicktest Professional Page 41

values.

Example
The following example shows Explore in use.
Option Explicit
Private Const CSIDL_PERSONAL = 5
Dim oShell32
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
[Link](CSIDL_PERSONAL)
'--- Cleaning objects
Set oShell32 = Nothing

Figure 4 - Explore Window

[Link] Method

The ExplorerPolicy method retrieves the value of a Microsoft Internet Explorer

policy.
Syntax

[Link] (bstrPolicyName)

Arguments
Parameter Description
bstrPolicyName Required. String that specifies the name of the Internet Explorer policy.

Return Value
Variant that receives the value of the specified Internet Explorer policy.

Network Administrators can control and manage the computing environment

of their users by setting policies.

Dani Vainstein Shell32 Page 41 of 68

Chapter 11 Scripting Quicktest Professional Page 42

[Link] Method

The Explore method opens a specified folder in a Microsoft Windows Explorer

window.
Syntax

[Link]()

Return Value
No return value.

Figure 5 - File Run Dialog

[Link] Method

The FindComputer method Displays the Search Results - Computers dialog

box. The dialog box shows the result of the search for a specified computer.
Syntax

[Link] ()

Return Value
No return value.

Dani Vainstein Shell32 Page 42 of 68

Chapter 11 Scripting Quicktest Professional Page 43

Figure 6 - Find Computer Dialog

[Link] Method

The FindFiles method Displays the Find: All Files dialog box. This is the same
as clicking the Start menu, selecting Find, and then selecting Files or Folders.
Syntax

[Link] ()

Return Value
No return value.

Dani Vainstein Shell32 Page 43 of 68

Chapter 11 Scripting Quicktest Professional Page 44

Figure 7 - Find Files Dialog

[Link] Method

The FindPrinter method displays the Find Printer dialog box to allow the user
to find a printer.
Syntax

[Link] (sName, sLocation, sModel)

Arguments
Parameter Description
sName Optional. String that contains the printer name.
sLocation Optional. String that contains the printer location.
sModel Optional. String that contains the printer model.

Return Value
No return value.

If you assign strings to one or more of the optional parameters, they are

Dani Vainstein Shell32 Page 44 of 68

Chapter 11 Scripting Quicktest Professional Page 45

displayed as default values in the associated edit control when the Find
Printer dialog box is displayed.
The user can either accept or override these values. If no value is assigned
to a parameter, the associated edit box is empty and the user must enter a
value.

Figure 8 - Find Printer dialog

[Link] Method

The GetSetting method retrieves a Shell global setting.

Syntax

[Link] (nSetting)

Arguments
Parameter Description
Required. A value of type Integer that specifies the current Shell
nSetting settings to retrieve. The SHGetSetSettings Enumerated Type described
on Table 10 on page 66.

Return Value
Boolean that returns true if the setting exists, or false otherwise.

[Link] Method

The GetSystemInformation method retrieves a Shell global setting.

Syntax

[Link] (sName)

Arguments
Parameter Description

Dani Vainstein Shell32 Page 45 of 68

Chapter 11 Scripting Quicktest Professional Page 46

Required. String that specifies the system info that is being

sName
requested.

Return Value
Returns the requested system information value. The return type depends on
what system information is requested.

This method can be used to request a number of system information values.

The following table gives the sName value that is used to request the
information and the type of the returned value.
Return
sName Description
Type
DirectoryServiceAvailable Boolean Set to true if directory service is available, or
false otherwise.
DoubleClickTime Integer The double-click time, in milliseconds.
ProcessorLevel Integer The processor level. Returns 3, 4, or 5, for x386,
x486, and Pentium-level processors, respectively.
ProcessorSpeed Integer The processor speed, in megahertz (MHz).
ProcessorArchitecture Integer The processor architecture. For details, see the
discussion of the wProcessorArchitectureType
SYSTEM_INFO Values on Table 11 on page 66
PhysicalMemoryInstalled Integer Amount of physical memory installed, in bytes.

[Link] Method

The Help method displays the Microsoft Windows Help and Support Center. This
method has same effect as clicking the Start menu and selecting Help and
Support.
Syntax

[Link] ()

Return Value
No return value.

Dani Vainstein Shell32 Page 46 of 68

Chapter 11 Scripting Quicktest Professional Page 47

Figure 9 – Help Dialog

[Link] Method

The IsRestricted method retrieves the registry's data value for a given group's
restriction value.
Syntax

[Link] (sGroup, sRestriction)

Arguments
Parameter Description
sGroup Required. The group (key) name under which to check for the restriction.
sRestriction Required. The restriction whose data value is to be retrieved.

Return Value
The value of the restriction. If the specified restriction is not found, the return
value is 0.

IsRestricted first looks for a registry key name matching sGroup under the
following key.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\policies

Dani Vainstein Shell32 Page 47 of 68

Chapter 11 Scripting Quicktest Professional Page 48

[Link] Method

The IsServiceRunning method returns a value that indicates whether a named

service is running.
Syntax

[Link] (sServiceName)

Arguments
Parameter Description
sServiceName Required. String that contains the service's name.

Return Value
Returns true if the service specified by sServiceName is running, or false
otherwise.
Example
The following example shows the proper usage of IsServiceRunning inside a
public function
Public Function fIsServiceRunning(ByVal sServiceName)
Dim oShell32
Set oShell32 = CreateObject("[Link]")
fIsServiceRunning = [Link](sServiceName)
Set oShell32 = nothing
End function

[Link] Method

The Help method Minimizes all of the windows on the desktop. This method has
the same effect as right-clicking the taskbar and selecting Minimize All Windows
on older systems or clicking the Show Desktop icon in the Quick Launch area of
the taskbar in Microsoft Windows 2000 or Windows XP.
Syntax

[Link] ()

Return Value
No return value.

Figure 10 – MinimizeAll Icon

Dani Vainstein Shell32 Page 48 of 68

Chapter 11 Scripting Quicktest Professional Page 49

[Link] Method

The NameSpace method creates and returns a Folder object for the specified
folder.
Syntax

[Link] (vDir)

Arguments
Parameter Description
Required. Specifies the folder for which to create the Folder object. This
can be a string that specifies the path of the folder or one of the
vDir
[Link] values in Table 7–
[Link] Values on page 65.
Return Value
Object reference to the Folder object for the specified folder. If the folder is not
successfully created, this value returns null.
Example
The following example shows NameSpace in use.
Public Function fGetShellNameSpace(ByVal vDir, ByRef sTitle)
Dim oShell32, oFolder
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](vDir)
If (Not objFolder Is Nothing) then
sTitle = [Link]
End If
set oFolder = Nothing
set oShell32 = Nothing
End function

[Link] Method

The Open method opens the specified folder.

Syntax

[Link] (vDir)

Dani Vainstein Shell32 Page 49 of 68

Chapter 11 Scripting Quicktest Professional Page 50

No return value.

If vDir is set to one of the [Link] and the special

folder does not exist, this function will create the folder.

Same as command-line “Explorer c:\Windows”

[Link] Method

The RefreshMenu method refreshes the contents of the Start menu. Used only
with systems preceeding Microsoft Windows XP.
Syntax

[Link] ()

Return Value
No return value.
Remarks
The functionality that RefreshMenu provides is handled automatically under
Windows XP or later. Do not call this method under that operating system.

[Link] Method

The ServiceStop method stops a named service.

Syntax

[Link] (sServiceName, vPersistent)

Arguments
Parameter Description
sServiceName Required. String that contains the service's name.
Required. Variant that is set to true to have the service started by the
vPersistent service control manager when ServiceStart is called. To leave the
service configuration unchanged, set vPersistent to false.

Return Value
Returns true if successful, or false otherwise.

[Link] Method

The ShellExecute method stops a named service.

Syntax

Dani Vainstein Shell32 Page 50 of 68

Chapter 11 Scripting Quicktest Professional Page 51

[Link](sFile,vArguments,vDirectory,vOperation,vShow)

Arguments
Parameter Description
Required. String that contains the name of the file on which
sFile
ShellExecute will perform the action specified by vOperation.
vArguments Optional. Variant that contains the parameter values for the operation.
Optional. Variant that contains the fully qualified path of the directory
vDirectory that contains the file specified by sFile. If this parameter is not specified,
the current working directory is used.
Optional. Variant that specifies the operation to be performed. It should
be set to one of the verb strings that is supported by the file. For a
vOperation
discussion of verbs, see the Remarks section. If this parameter is not
specified, the default operation is performed.
Optional. Variant that recommends how the window that belongs to the
vShow application that performs the operation should be displayed initially. The
application can ignore this recommendation.

vShow can take one of the following values. If this parameter is not specified,
the application uses its default value.
Value Description
0 Open the application with a hidden window.
Open the application with a normal window. If the window is minimized or
1
maximized, the system restores it to its original size and position.
2 Open the application with a minimized window.
3 Open the application with a maximized window.
Open the application with its window at its most recent size and position. The
4
active window remains active.
5 Open the application with its window at its current size and position.
Open the application with a minimized window. The active window remains
7
active.
Open the application with its window in the default state specified by the
10
application.

Remarks
This method is equivalent to launching one of the commands associated with
a file's shortcut menu. Each command is identified by a verb string. The
supported verbs vary from file to file. The most commonly supported verb is
"open", which is also usually the default verb. Others might be supported
only by certain types of files.

[Link] Method

The SetTime method Displays the Date and Time Properties dialog box. This

Dani Vainstein Shell32 Page 51 of 68

Chapter 11 Scripting Quicktest Professional Page 52

method has the same effect as right-clicking the clock in the taskbar status area
and selecting Adjust Date/Time.
Syntax

[Link] ()

Figure 11 - Date and Time Properties Dialog

[Link] Method

Not Supported By QuickTest

Description

Professional
The ShowBrowserBar method stops a named service.
Syntax

[Link] ( sCLSID, vShow )

Arguments
Parameter Description
Required. String that contains the string form of the class identifier
(CLSID) of the browser bar to be displayed. The object must be
sCLSID
registered as an Explorer Bar object with a CATID_InfoBand
component category.
Required. Variant that is set to true to show the browser bar, or false
vShow
to hide it.

Return Value
Variant. Returns true if successful, or false otherwise.

You can display one of the standard Explorer Bars by setting sCLSID to its

Dani Vainstein Shell32 Page 52 of 68

Chapter 11 Scripting Quicktest Professional Page 53

CLSID string. The standard Explorer Bars and their CLSID strings are as
follows.
Explorer Bar CLSID string
Favorites {EFA24E61-B078-11d0-89E4-00C04FC9E26E}
Folders {EFA24E64-B078-11d0-89E4-00C04FC9E26E}
History {EFA24E62-B078-11d0-89E4-00C04FC9E26E}
Search {30D02401-6A81-11d0-8274-00C04FD5AE38}

[Link] Method

Displays the Shut Down Windows dialog box. This is the same as clicking the
Start menu and selecting Shut Down.
Syntax

[Link] ()

Return Value
No return value.

Figure 12 – Suht Down Windows Dialog

[Link] Method

The TileHorizontally method Tiles all of the windows on the desktop

horizontally. This method has the same effect as right-clicking the taskbar and
selecting Tile Windows Horizontally.
Syntax

[Link]()

Return Value
No return value.

Dani Vainstein Shell32 Page 53 of 68

Chapter 11 Scripting Quicktest Professional Page 54

Figure 13 – Tile Windows Horizontally

[Link] Method

The TileHorizontally method Tiles all of the windows on the desktop vertically.
This method has the same effect as right-clicking the taskbar and selecting Tile
Windows Vertically..
Syntax

[Link] ()

Return Value
No return value.

Figure 14 – Tile Windows Vertically

[Link] Method

The ToggleDesktop method raises and lowers the desktop.

Syntax

[Link] ( )

Return Value
No return value.

Dani Vainstein Shell32 Page 54 of 68

Chapter 11 Scripting Quicktest Professional Page 55

Remarks
This method behaves like the toggle desktop icon on the quick launch bar. It
hides all open windows and shows the desktop, or hides the desktop and
shows all open windows.
The ToggleDesktop method does not display any user interface, it just
invokes the toggle action.
This methos is similar to MinimizeAll

Figure 15 - Show Desktop

[Link] Method

The TrayProperties method Displays the Taskbar and Start Menu Properties
dialog box. This method has the same effect as right-clicking the taskbar and
selecting Properties.
Syntax

[Link]()

Return Value
No return value.

Figure 16 – Task

Dani Vainstein Shell32 Page 55 of 68

Chapter 11 Scripting Quicktest Professional Page 56

[Link] Method

The UndoMinimizeAll method Restores all of the windows on the desktop to

the same state they were in before the last MinimizeAll command. This method
has the same effect as right-clicking the taskbar and selecting Undo Minimize All
Windows on older systems or a second clicking of the Show Desktop icon in the
Quick Launch area of the taskbar in Microsoft Windows 2000 or Windows XP.
Syntax

[Link] ()

Return Value
No return value.

[Link] Method

The Windows method Creates and returns a ShellWindows object. This object
represents a collection of all of the open windows that belong to the Shell.
Syntax

[Link] ()

Return Value
Object reference to the ShellWindows object.

[Link] Method

Not Supported By QuickTest

Professional
Figure 17 - Show Desktop

The WindowsSecurity method displays the Windows Security dialog box.

Syntax

[Link] ( )

Return Value
No return value.
Remarks
Using this method provides the same results as pressing CTRL+ALT+DELETE
or using the security option that is on the Start menu when you connect
using Microsoft Terminal Server.
This method will work only when connected via a terminal session to

Dani Vainstein Shell32 Page 56 of 68

Chapter 11 Scripting Quicktest Professional Page 57

Microsoft Terminal Server.

[Link] Object

The Shell object represents the objects in the Shell. Methods are provided to
control the Shell and to execute commands within the Shell. There are also
methods to obtain other Shell-related objects.

[Link] Property

The Terget property contains the link object's target.

Data Type
Object expression that evaluates to the target's FolderItem object.

The property is read-only. The property has no default value.

[Link] Object

This object extends the FolderItem object. In addition to the properties and
methods supported by FolderItem, ShellFolderItem has two additional methods.

[Link] Method

The ExtendedProperty method returns the value of a property from an item's

property set. The property can be specified either by name or by the property
set's format identifier (FMTID) and property identifier (PID).
Syntax

[Link] ( sPropName )

Arguments
Parameter Description
Required. String value that specifies the property. See the Remarks
sPropName
section for details.

Return Value
Variant. Returns the value of the property, if it exists for the specified item. The
value will have full typingfor example, dates will be returned as dates, not
strings.
Remarks
This method returns a zero-length string if the property is valid but does not
exist for the specified item, or an OLE error code otherwise.
There are two ways to specify a property. The first is to assign the property's

Dani Vainstein Shell32 Page 57 of 68

Chapter 11 Scripting Quicktest Professional Page 58

well-known name, such as "Author" or "Date", to sPropName. However, each

property is a member of a Component Object Model (COM) property set
and can also be identified by specifying its format ID (FMTID) and property
ID (PID). An FMTID is a GUID that identifies the property set, and a PID is
an integer that identifies a particular property within the property set.
Specifying a property by its FMTID/PID values is usually more efficient
than using its name. To use a property's FMTID/PID values with
ExtendedProperty, they must be combined into an SCID. An SCID is a
string that contains the FMTID/PID values in the form "FMTIDPID", where
the FMTID is the string form of the property set's globally unique identifier
(GUID).
For a list of FMTIDs and PIDs that are currently supported by the Shell, see
SHCOLUMNID values in Table 12 on page 68.
Example
The following example uses Item to retrieve the extended properties of a
document file using the ExtendedProperty method
Option Explicit
Private Const CSIDL_WINDOWS = 36
Private Const SHCONTF_NONFOLDERS = 64
Dim oShell32, oFolder, oFolderItem, oFolderItems
Dim nCount
'--- Creating a shell application object
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](CSIDL_WINDOWS)
'--- Checking Folder object validation
If (Not oFolder Is Nothing) then
'--- Retrieve the FolderItems collection object
Set oFolderItems = [Link]()
'--- Validation...
If (Not oFolderItems Is Nothing) Then
nCount = [Link]
Msgbox "Items before Filter = " & nCount, 0, "Filter Method"
[Link] SHCONTF_NONFOLDERS, "*.exe"
nCount = [Link]
Msgbox "Items after Filter = " & nCount, 0, "Filter Method"
End if
Set oFolderItem = Nothing : Set oFolderItems = Nothing
End If
'--- Cleaning objects
Set oFolder = Nothing : Set oShell32 = Nothing

Q&A

How to list items in the administrative tools folder?

Option Explicit
Const CSIDL_COMMON_ADMINTOOLS = &H2f
Dim oShell, oFolder, oItem
Dim nRow : nRow = 1

Dani Vainstein Shell32 Page 58 of 68

Chapter 11 Scripting Quicktest Professional Page 59

'--- Creating an entry in local datasheet

[Link] "ITEM_NAME", ""
'--- Creating a new shell application object
Set oShell = CreateObject("[Link]")
Set oFolder = [Link](CSIDL_COMMON_ADMINTOOLS)
'--- Retrieving collection of items
For Each oItem in [Link]
[Link] nRow
DataTable("ITEM_NAME", dtLocalSheet) = [Link]
nRow = nRow + 1
Next
Set oShell = Nothing

How to list items in the "My Music" folder?

Option Explicit
Const CSIDL_MYMUSIC = 13
Dim oShell, oFolder, oItem
Dim nRow : nRow = 1
'--- Creating an entry in local datasheet
[Link] "ITEM_NAME", ""
'--- Creating a new shell application object
Set oShell = CreateObject("[Link]")
Set oFolder = [Link](CSIDL_MYMUSIC)
'--- Retrieving collection of items
For Each oItem in [Link]
[Link] nRow
DataTable("ITEM_NAME", dtLocalSheet) = [Link]
nRow = nRow + 1
Next
Set oShell = Nothing

How to retrieve the path to "Common Desktop" folder?

Option Explicit
Const CSIDL_COMMON_DESKTOPDIR = 25
Dim oShell, oFolder, oFolderItem
Dim nRow : nRow = 1
'--- Creating an entry in local datasheet
[Link] "ITEM_NAME", ""
'--- Creating a new shell application object
Set oShell = CreateObject("[Link]")

Dani Vainstein Shell32 Page 59 of 68

Chapter 11 Scripting Quicktest Professional Page 60

Set oFolder = [Link](CSIDL_COMMON_DESKTOPDIR)

Set oFolderItem = [Link]
MsgBox [Link]
Set oFolderItem = Nothing : Set oShell = Nothing

How to list the local computer information?

Option Explicit
Dim oComp
Dim sInfo
Set oComp = CreateObject("[Link]")
sInfo = "Computer name: " & [Link] & vbCrLf
sInfo = sInfo & "Shutdown allowed: " & [Link] & vbCrLf
sInfo = sInfo & "Friendly UI enabled: " & [Link] & vbCrLf
sInfo = sInfo & "Guest access mode: " & [Link] & vbCrLf
sInfo = sInfo & "Guest account enabled: " & [Link](0) & vbCrLf
sInfo = sInfo & "Multiple users enabled: " & [Link] & vbCrLf
sInfo = sInfo & "Offline files enabled: " & [Link] & vbCrLf
sInfo = sInfo & "Remote conn. enabled: " & [Link] & vbCrLf
sInfo = sInfo & "Undock enabled: " & [Link] & vbCrLf
MsgBox sInfo, 0, "Local Computer Information"
Set oComp = Nothing

How to add a web site to the favorites menu?

Option Explicit
Const CSIDL_FAVORITES = 6
Set oShell32, oShell, oFolder, oFolderItem, oURLShortcut
Dim sDesktopFld
'--- Creating a application object
Set oShell32 = CreateObject("[Link]")
Set oFolder = [Link](CSIDL_FAVORITES)
'--- Using the favorites folder for the path.
Set oFolderItem = [Link]
sDesktopFld = [Link]
'--- Creating a shell folder to use the URLShortcut object
Set oShell = CreateObject("[Link]")
Set oURLShortcut = [Link](sDesktopFld & "\MSDN [Link]")
[Link] = "[Link]
[Link]

Dani Vainstein Shell32 Page 60 of 68

Chapter 11 Scripting Quicktest Professional Page 61

'--- Cleaning
Set oURLShortcut = Nothing : Set oShell = Nothing : Set oComp = Nothing

Appendix 14.A – Shell32 Constants

QuotaStateConstants Values
Constant Value Description
dqStateDisable 0 Disk quotas are disabled.
dqStateTrack 1 Disk quotas are disabled.

dqStateEnforce 2 Enforce quota limit.

Table 1 – QuotaStateConstants Values

UserNameResolutionConstants Values
Constant Val Description
dqResolveNone 0 Do not resolve user name information.
dqResolveSync 1 Wait while resolving name information.
dqResolveAsync 2 Do not wait while resolving name information. The OnUserNameChanged
event fires when the name is resolved.

Table 2 – UserNameResolutionConstants Values

QuotaStateConstants Values
Constant Value Description
dqAcctResolved 0 Account information is resolved.
dqAcctUnavailable 1 Account information is unavailable.
dqAcctDeleted 2 Account has been deleted.
dqAcctInvalid 3 Account is invalid.
dqAcctUnknown 4 Account cannot be found.

Table 3 – AccountStatus Values

[Link] Values
Constant Value Description
OFS_DIRTYCACHE 3 Server is online with unsynchronized changes.
OFS_INACTIVE -1 Offline caching is not enabled for this folder.
OFS_OFFLINE 1 Server is offline.
OFS_ONLINE 0 Server is online.
OFS_SERVERBACK 2 Server is offline but can be reached.

Table 4 – [Link] Values

Dani Vainstein Shell32 Page 61 of 68

Chapter 11 Scripting Quicktest Professional Page 62

SHFILEOPSTRUCT Values
Constant Value Description
FOF_SILENT 4 Do not display a progress dialog box.
Give the file being operated on a new name in a move,
FOF_RENAMEONCOLLISION 8 copy, or rename operation if a file with the target
name already exists.
Respond with "Yes to All" for any dialog box that is
FOF_NOCONFIRMATION 16
displayed.
FOF_ALLOWUNDO 64 Preserve undo information, if possible.
Perform the operation on files only if a wildcard file
FOF_FILESONLY 128
name (*.*) is specified.
Display a progress dialog box but do not show the file
FOF_SIMPLEPROGRESS 256
names.
Do not confirm the creation of a new directory if the
FOF_NOCONFIRMMKDIR 512
operation requires one to be created.

FOF_NOERRORUI 1024 Do not display a user interface if an error occurs.

FOF_NOCOPYSECURITYATTRIBS 2048 Do not copy the security attributes of the file.
Only operate in the local directory. Don't operate
FOF_NORECURSION 4096
recursively into subdirectories.
Version 5.0. Do not copy connected files as a group.
FOF_NO_CONNECTED_ELEMENTS 9182
Only copy the specified files.

Table 5 – SHFILEOPSTRUCT Values

Details Options Values

Index Property Index Property
0 Name 18 Year
1 Size 19 Track Number
2 Type 20 Genre
3 Date Modified 21 Duration
4 Date Created 22 Bit Rate
5 Date Accessed 23 Protected
6 Attributes 24 Camera Model
7 Status 25 Date Picture Taken
8 Owner 26 Dimensions
9 Author 27 Not used
10 Title 28 Not used
11 Subject 29 Not used
12 Category 30 Company
13 Pages 31 Description
14 Comments 32 File Version
15 Copyright 33 Product Name

Dani Vainstein Shell32 Page 62 of 68

Chapter 11 Scripting Quicktest Professional Page 63

16 Artist 34 Product Version

17 Album Title -1 Retrieves the info tip information for the item.

Table 6 – Details Options Values

[Link] Values
Constant Val Description
The file system directory that is used to store administrative
tools for an individual user. The Microsoft Management
CSIDL_ADMINTOOLS 48
Console (MMC) will save customized consoles to this
directory, and it will roam with the user.

File system directory that corresponds to the user's

29
CSIDL_ALTSTARTUP nonlocalized Startup program group.
File system directory that serves as a common repository for
26 application-specific data. A typical path is C:\Documents and
CSIDL_APPDATA
Settings\username\Application Data.
Virtual folder containing the objects in the user's Recycle
10
CSIDL_BITBUCKET Bin.
The file system directory acting as a staging area for files
waiting to be written to CD. A typical path is C:\Documents
CSIDL_CDBURN_AREA 59
and Settings\username\Local Settings\Application
Data\Microsoft\CD Burning.
The file system directory containing administrative tools for
CSIDL_COMMON_ADMINTOOLS 47
all users of the computer.
File system directory that corresponds to the nonlocalized
30 Startup program group for all users. Valid only for Microsoft
CSIDL_COMMON_ALTSTARTUP
Windows NT systems.
Application data for all users. A typical path is C:\Documents
35
CSIDL_COMMON_APPDATA and Settings\All Users\Application Data.
File system directory that contains files and folders that
appear on the desktop for all users. A typical path is
25
CSIDL_COMMON_DESKTOPDIR C:\Documents and Settings\All Users\Desktop. Valid only for
Windows NT systems.
The file system directory that contains documents that are
CSIDL_COMMON_DOCUMENTS 46 common to all users. A typical paths is C:\Documents and
Settings\All Users\Documents.
File system directory that serves as a common repository for
31
CSIDL_COMMON_FAVORITES all users' favorite items. Valid only for Windows NT systems.
The file system directory that serves as a repository for
CSIDL_COMMON_MUSIC 53 music files common to all users. A typical path is
C:\Documents and Settings\All Users\Documents\My Music.
The file system directory that serves as a repository for
image files common to all users. A typical path is
CSIDL_COMMON_PICTURES 54
C:\Documents and Settings\All Users\Documents\My
Pictures.
File system directory that contains the directories for the
common program groups that appear on the Start menu for
23 all users. A typical path is C:\Documents and Settings\All
CSIDL_COMMON_PROGRAMS
Users\Start Menu\Programs. Valid only for Windows NT
systems.
File system directory that contains the programs and folders
22 that appear on the Start menu for all users. A typical path is
CSIDL_COMMON_STARTMENU
C:\Documents and Settings\All Users\Start Menu. Valid only

Dani Vainstein Shell32 Page 63 of 68

Chapter 11 Scripting Quicktest Professional Page 64

for Windows NT systems.

File system directory that contains the programs that appear
in the Startup folder for all users. A typical path is
24
CSIDL_COMMON_STARTUP C:\Documents and Settings\All Users\Start
Menu\Programs\Startup. Valid only for Windows NT systems.
The file system directory that contains the templates that
CSIDL_COMMON_TEMPLATES 45 are available to all users. A typical path is C:\Documents and
Settings\All Users\Templates.
The file system directory that serves as a repository for
CSIDL_COMMON_VIDEO 55 video files common to all users. A typical path is
C:\Documents and Settings\All Users\Documents\My Videos.

CSIDL_COMPUTERSNEARME 61 The folder representing other machines in your workgroup.

The virtual folder representing Network Connections,
CSIDL_CONNECTIONS 49
containing network and dial-up connections.
Virtual folder containing icons for the Control Panel
3
CSIDL_CONTROLS applications.
File system directory that serves as a common repository for
33 Internet cookies. A typical path is C:\Documents and
CSIDL_COOKIES
Settings\username\Cookies.
Microsoft Windows Desktop virtual folder that is the root of
0
CSIDL_DESKTOP the namespace.
The file system directory used to physically store file objects
on the desktop (not to be confused with the desktop folder
16
CSIDL_DESKTOPDIRECTORY itself). A typical path is C:\Documents and
Settings\username\Desktop.
The virtual folder representing My Computer, containing
everything on the local computer: storage devices, printers,
17
CSIDL_DRIVES and Control Panel. The folder may also contain mapped
network drives.
File system directory that serves as a common repository for
6 the user's favorite items. A typical path is C:\Documents and
CSIDL_FAVORITES
Settings\username\Favorites.
Virtual folder containing installed fonts. A typical path is
20
CSIDL_FONTS C:\WINNT\Fonts.
File system directory that serves as a common repository for
CSIDL_HISTORY 34
Internet history items.
CSIDL_INTERNET 1 A viritual folder for Internet Explorer (icon on desktop).
File system directory that serves as a common repository for
CSIDL_INTERNET_CACHE 32 temporary Internet files. A typical path is C:\Documents and
Settings\username\Temporary Internet Files.
File system directory that serves as a data repository for
local (non-roaming) applications. A typical path is
CSIDL_LOCAL_APPDATA 28
C:\Documents and Settings\username\Local
Settings\Application Data.
The virtual folder representing the My Documents desktop
CSIDL_MYDOCUMENTS 12
item.

The file system directory that serves as a common

CSIDL_MYMUSIC 13 repository for music files. A typical path is C:\Documents
and Settings\User\My Documents\My Music.
My Pictures folder. A typical path is C:\Documents and
CSIDL_MYPICTURES 39
Settings\username\My Documents\My Pictures.

CSIDL_MYVIDEO 14 The file system directory that serves as a common

repository for video files. A typical path is C:\Documents and

Dani Vainstein Shell32 Page 64 of 68

Chapter 11 Scripting Quicktest Professional Page 65

Settings\username\My Documents\My Videos.

A file system folder containing the link objects that may
exist in the My Network Places virtual folder. It is not the
CSIDL_NETHOOD 19 same as ssfNETWORK, which represents the network
namespace root. A typical path is C:\Documents and
Settings\username\NetHood.
Network Neighborhood virtual folder representing the root of
CSIDL_NETWORK 18
the network namespace hierarchy.
File system directory that serves as a common repository for
CSIDL_PERSONAL 5 a user's documents. A typical path is C:\Documents and
Settings\username\My Documents.

This documentation is preliminary and is subject to change.

CSIDL_PHOTOALBUMS 69 Windows Vista and later. The virtual folder used to store
photo albums, typically username\My Pictures\Photo
Albums.
This documentation is preliminary and is subject to change.
CSIDL_PLAYLISTS 63 Windows Vista and later. The virtual folder used to store play
albums, typically username\My Music\Playlists.
CSIDL_PRINTERS 4 Virtual folder containing installed printers.
File system directory that contains the link objects that may
CSIDL_PRINTHOOD 27 exist in the Printers virtual folder. A typical path is
C:\Documents and Settings\username\PrintHood.
CSIDL_PROFILE 40 User's profile folder.
CSIDL_PROGRAM_FILES 38 Program Files folder. A typical path is C:\Program Files.
CSIDL_PROGRAM_FILES_COMM A folder for components that are shared across applications.
43
ON A typical path is C:\Program Files\Common.
File system directory that contains the user's program
groups (which are also file system directories). A typical
CSIDL_PROGRAMS 2
path is C:\Documents and Settings\username\Start
Menu\Programs.
File system directory that contains the user's most recently
CSIDL_RECENT 8 used documents. A typical path is C:\Documents and
Settings\username\Recent.
File system directory that contains Send To menu items. A
CSIDL_SENDTO 9 typical path is C:\Documents and
Settings\username\SendTo.
File system directory containing Start menu items. A typical
CSIDL_STARTMENU 12
path is C:\Documents and Settings\username\Start Menu.
File system directory that corresponds to the user's Startup
program group. The system starts these programs whenever
CSIDL_STARTUP 7 any user logs onto Windows NT or starts Windows 95. A
typical path is C:\Documents and Settings\username\Start
Menu\Programs\Startup.
CSIDL_SYSTEM 37 System folder. A typical path is C:\WINNT\SYSTEM32.
File system directory that serves as a common repository for
CSIDL_TEMPLATES 21
document templates.
Windows directory or SYSROOT. This corresponds to
CSIDL_WINDOWS 36 the %windir% or %SYSTEMROOT% environment variables.
A typical path is C:\WINNT.

Table 7 – [Link] Values

Dani Vainstein Shell32 Page 65 of 68

Chapter 11 Scripting Quicktest Professional Page 66

[Link] Values
Constant Val Description
SFVVO_SHOWALLOBJECTS 1 The Show All Files option is enabled.
The Hide File Extensions for Known File Types option is
SFVVO_SHOWEXTENSIONS 2
disabled.
The Display Compressed Files and Folders with Alternate
SFVVO_SHOWCOMPCOLOR 8
Color option is enabled.
SFVVO_SHOWSYSFILES 32 The Do Not Show Hidden Files option is enabled.
SFVVO_WIN95CLASSIC 64 The Classic Style option is enabled.
SFVVO_DOUBLECLICKINWEBVIEW 128 The Double-Click to Open an Item option is enabled.
SFVVO_DESKTOPHTML 512 The Active Desktop View as Web Page option is enabled.

Table 8 – [Link] Values

SHCONTF Enumerated Type Values

Constant Value Description
SHCONTF_FOLDERS 32 Include items that are folders in the enumeration.
SHCONTF_NONFOLDERS 64 Include items that are not folders in the enumeration.
SHCONTF_INCLUDEHIDDEN 128 Include hidden items in the enumeration.
SHCONTF_NETPRINTERSRCH 512 The caller is looking for printer objects.
SHCONTF_SHAREABLE 1024 The caller is looking for remote shares.
SHCONTF_STORAGE 2048 Include items with accessible storage and their ancestors.

Table 9 – SHCONTF Enumerated Type Values

SHGetSetSettings Enumerated Type Values

Constant Value Description
SSF_DESKTOPHTML The state of the Active Desktop.
SSF_DONTPRETTYPATH The state of the Allow all uppercase names option.
SSF_DOUBLECLICKINWEBVIEW The state of the Double-click to open an item option.
SSF_FILTER Not used.
SSF_HIDEICONS The state of Desktop icons.
The state of the Show map network drive button in
SSF_MAPNETDRVBUTTON
toolbar option.
The state of the Recycle Bin's Display delete confirmation
SSF_NOCONFIRMRECYCLE
dialog option.
The state of the Automatically search for network folders
SSF_NONETCRAWLING
and printers option.
The state of the Launch folder windows in a separate
SSF_SEPPROCESS
process option.
SSF_SERVERADMINUI Not used.
SSF_SHOWALLOBJECTS The state of the Show hidden files and folders option.
SSF_SHOWATTRIBCOL The state of the Show File Attributes in Detail View

Dani Vainstein Shell32 Page 66 of 68

Chapter 11 Scripting Quicktest Professional Page 67

option.
The state of the Show encrypted or compressed NTFS
SSF_SHOWCOMPCOLOR
files in color option.
The state of the Hide extensions for known file types
SSF_SHOWEXTENSIONS
option.
The state of the Show pop-up description for folder and
SSF_SHOWINFOTIP
desktop items option.
SSF_SHOWSTARTPAGE Not used.

The state of the Do not show hidden files and folders

SSF_SHOWSYSFILES
option.
The state of the Hide protected operating system files
SSF_SHOWSUPERHIDDEN
option.
SSF_WEBVIEW Display as a Web View
SSF_WIN95CLASSIC The state of the Classic Style option.

Table 10 – SHGetSetSettings Enumerated Type Values

wProcessorArchitectureType SYSTEM_INFO Values

Constant Value Description
PROCESSOR_ARCHITECTURE_AMD64 9 x64 (AMD or Intel)
PROCESSOR_ARCHITECTURE_IA32_ON_WIN64 10 WOW64
PROCESSOR_ARCHITECTURE_IA64 6 Intel Itanium Processor Family (IPF)
PROCESSOR_ARCHITECTURE_INTEL 0 x86
PROCESSOR_ARCHITECTURE_UNKNOWN &HFFFF Unknown processor.

Table 11 – wProcessorArchitectureType SYSTEM_INFO Values

SHCOLUMNID

SHCOLUMNID Values
PID Property Name Data Type
2 Title String
3 Subject String
4 Author String
5 Keywords String
6 Comments String
7 Template String
8 Last Saved By String

9 Revision Number String

10 Total Editing Time Date
11 Last Printed Date
12 Create Time/Date Date
13 Last Saved Time/Date Date
14 Number of Pages Integer
15 Number of Words Integer

Dani Vainstein Shell32 Page 67 of 68

Chapter 11 Scripting Quicktest Professional Page 68

16 Number of Characters Integer

17 Thumbnail VT_CF
18 Name of Creating Application String
19 Security Integer

Table 12 – SHCOLUMNID Values

Dani Vainstein Shell32 Page 68 of 68

Configuring File Server Resource Manager
No ratings yet
Configuring File Server Resource Manager
14 pages
Windows Dev Environment
No ratings yet
Windows Dev Environment
660 pages
Script Lab
No ratings yet
Script Lab
3 pages
Unit 3 Week 8 C Learners
No ratings yet
Unit 3 Week 8 C Learners
27 pages
PowerShell Basics for File Management
No ratings yet
PowerShell Basics for File Management
22 pages
Configuring File Server Resource Manager
67% (3)
Configuring File Server Resource Manager
13 pages
Set Up Your Windows Dev Environment
No ratings yet
Set Up Your Windows Dev Environment
692 pages
CompTIA A+ Windows Tools Lab Guide
No ratings yet
CompTIA A+ Windows Tools Lab Guide
122 pages
Command-Line Tools for AD Management
No ratings yet
Command-Line Tools for AD Management
52 pages
Create and Run PowerShell Scripts on Windows
No ratings yet
Create and Run PowerShell Scripts on Windows
36 pages
Shell Script for File Permissions Management
No ratings yet
Shell Script for File Permissions Management
5 pages
Comprehensive Guide To Batch Scripting and Automation Using Command Prompt
No ratings yet
Comprehensive Guide To Batch Scripting and Automation Using Command Prompt
5 pages
Windows Scripting Host
No ratings yet
Windows Scripting Host
19 pages
Create and Run PowerShell Scripts
No ratings yet
Create and Run PowerShell Scripts
9 pages
PowerShell Lab Exercises Overview
No ratings yet
PowerShell Lab Exercises Overview
4 pages
Control Panel Commands for Windows 8
No ratings yet
Control Panel Commands for Windows 8
5 pages
Server 2012 Webinar
No ratings yet
Server 2012 Webinar
41 pages
Active Directory Basics Course Overview
No ratings yet
Active Directory Basics Course Overview
12 pages
VBScript Quick Reference Guide
100% (3)
VBScript Quick Reference Guide
3 pages
Powers Hell
No ratings yet
Powers Hell
128 pages
Ansible for Windows Management Guide
No ratings yet
Ansible for Windows Management Guide
56 pages
Scripting QTP - Ch09 - WSH
No ratings yet
Scripting QTP - Ch09 - WSH
73 pages
LASU CSD 027 - Windows CLI Comprehensive Manual
No ratings yet
LASU CSD 027 - Windows CLI Comprehensive Manual
1 page
Active Directory Logon Script Guide
No ratings yet
Active Directory Logon Script Guide
4 pages
ITFPlus (FC0 U61) Module2 - Unit3 LE8
No ratings yet
ITFPlus (FC0 U61) Module2 - Unit3 LE8
8 pages
Advanced PowerShell Automation Course
No ratings yet
Advanced PowerShell Automation Course
8 pages
Windows Scripting Host Programmer's ReferenceProgrammer's Reference
100% (1)
Windows Scripting Host Programmer's ReferenceProgrammer's Reference
44 pages
Lesson 10: Using Support and Scripting Tools
No ratings yet
Lesson 10: Using Support and Scripting Tools
36 pages
VBScript Quick Reference Guide
No ratings yet
VBScript Quick Reference Guide
2 pages
VBScript Language Quick Reference Guide
No ratings yet
VBScript Language Quick Reference Guide
2 pages
VBScript Quick Reference Guide
No ratings yet
VBScript Quick Reference Guide
2 pages
Keyword Driven Testing Overview
No ratings yet
Keyword Driven Testing Overview
48 pages
PowerShell Scripting Essentials
No ratings yet
PowerShell Scripting Essentials
71 pages
Essential PowerShell Commands for Admins
No ratings yet
Essential PowerShell Commands for Admins
13 pages
PowerShell Best Practices Overview
No ratings yet
PowerShell Best Practices Overview
21 pages
Logon Script Basics and Examples
No ratings yet
Logon Script Basics and Examples
9 pages
DOS CLI DemoPlan Detailed
No ratings yet
DOS CLI DemoPlan Detailed
11 pages
KiXtart Scripting Quick Reference Guide
No ratings yet
KiXtart Scripting Quick Reference Guide
3 pages
Windows PowerShell Course Outline
No ratings yet
Windows PowerShell Course Outline
4 pages
SkillPipe Login Instructions
No ratings yet
SkillPipe Login Instructions
3 pages
Introduction to Windows Management Instrumentation
No ratings yet
Introduction to Windows Management Instrumentation
3 pages
Scripting Manual
No ratings yet
Scripting Manual
125 pages
Automating Administration with PowerShell
No ratings yet
Automating Administration with PowerShell
12 pages
Scriptingmaxwell Onlinehelp
No ratings yet
Scriptingmaxwell Onlinehelp
364 pages
Unix and Windows Admin Practical Tasks
No ratings yet
Unix and Windows Admin Practical Tasks
11 pages
AutoIt Automation Guide for Windows
No ratings yet
AutoIt Automation Guide for Windows
12 pages
Keyword Driven Testing Overview
No ratings yet
Keyword Driven Testing Overview
48 pages
Configuring File and Share Access Lab
No ratings yet
Configuring File and Share Access Lab
13 pages
GCIS-123: Command Line Basics
No ratings yet
GCIS-123: Command Line Basics
21 pages
Windows Batch Scripting Basics
100% (1)
Windows Batch Scripting Basics
42 pages
Microsoft Windows 2000 Scripting Guide.9780735618671.30579
No ratings yet
Microsoft Windows 2000 Scripting Guide.9780735618671.30579
1,463 pages
Directory File Upload Process
No ratings yet
Directory File Upload Process
3 pages
Python Folder Existence Check Guide
No ratings yet
Python Folder Existence Check Guide
12 pages
Advanced Lab Guide
No ratings yet
Advanced Lab Guide
21 pages
A VBScript18
100% (1)
A VBScript18
19 pages
Batch Scripting Complete Guide
No ratings yet
Batch Scripting Complete Guide
16 pages
Os Lab
No ratings yet
Os Lab
90 pages
Configuring File and Share Access Lab
No ratings yet
Configuring File and Share Access Lab
12 pages
Cs3451 Fixed Strict
No ratings yet
Cs3451 Fixed Strict
733 pages
C# DateTime Constructors Overview
100% (2)
C# DateTime Constructors Overview
151 pages
Understanding Win32 API in QuickTest
100% (2)
Understanding Win32 API in QuickTest
22 pages
Scripting QTP - CH14 - Working With Files
No ratings yet
Scripting QTP - CH14 - Working With Files
112 pages
Scripting QTP - CH05 - Regular Expressions
100% (2)
Scripting QTP - CH05 - Regular Expressions
30 pages
CSS Exam: Web Development Basics
No ratings yet
CSS Exam: Web Development Basics
2 pages
Big Data Hadoop Assignment Guide
No ratings yet
Big Data Hadoop Assignment Guide
5 pages
Functions and Components of Operating Systems
No ratings yet
Functions and Components of Operating Systems
25 pages
Advanced SQL Functions and Triggers
No ratings yet
Advanced SQL Functions and Triggers
98 pages
XFEM for Crack Propagation in Abaqus
No ratings yet
XFEM for Crack Propagation in Abaqus
11 pages
8-Bit PIC® Microcontrollers
100% (3)
8-Bit PIC® Microcontrollers
12 pages
Computer Awareness for NABARD Grade A
No ratings yet
Computer Awareness for NABARD Grade A
10 pages
GetTempFileNameA Function Overview
No ratings yet
GetTempFileNameA Function Overview
4 pages
Complete Network Course
100% (1)
Complete Network Course
14 pages
Python Conditional Structures Overview
No ratings yet
Python Conditional Structures Overview
33 pages
Secure, Fast & Private Web Browser With Adblocker - Brave Browser
No ratings yet
Secure, Fast & Private Web Browser With Adblocker - Brave Browser
12 pages
B1 Preliminary Classroom Activities Guide
No ratings yet
B1 Preliminary Classroom Activities Guide
13 pages
MVC Framework for Interactive Systems
No ratings yet
MVC Framework for Interactive Systems
13 pages
Kisi-Kisi Soal Bahasa Inggris 2024/2025
No ratings yet
Kisi-Kisi Soal Bahasa Inggris 2024/2025
8 pages
Diploma Programs in IT and AI/ML
No ratings yet
Diploma Programs in IT and AI/ML
1 page
Relational Database and SQL Worksheets
No ratings yet
Relational Database and SQL Worksheets
9 pages
Understanding Hardware and Software
No ratings yet
Understanding Hardware and Software
13 pages
ESP32 v5 WiFi+BT+GPS for Nexstar
No ratings yet
ESP32 v5 WiFi+BT+GPS for Nexstar
36 pages
5G Fundamentals and Design Qualcomm PDF
100% (3)
5G Fundamentals and Design Qualcomm PDF
23 pages
Save Student Marks Form for Teachers
No ratings yet
Save Student Marks Form for Teachers
4 pages
ArcGIS On-Screen Digitizing Course
No ratings yet
ArcGIS On-Screen Digitizing Course
10 pages
Dynamics 365 QA Engineer Resume
No ratings yet
Dynamics 365 QA Engineer Resume
1 page
Pitney Ship Pro Access Request Guide
No ratings yet
Pitney Ship Pro Access Request Guide
8 pages
Titanium Ti-89 PDF
No ratings yet
Titanium Ti-89 PDF
1,008 pages
ReadMe PDF
No ratings yet
ReadMe PDF
4 pages
Software Testing Fundamentals Explained
No ratings yet
Software Testing Fundamentals Explained
32 pages
Social Networks Presentation Outline
No ratings yet
Social Networks Presentation Outline
10 pages
Overview of Solid State Drives (SSD)
No ratings yet
Overview of Solid State Drives (SSD)
11 pages
Cracking Delphi Programs Guide
No ratings yet
Cracking Delphi Programs Guide
11 pages
Introduction to Cryptography Concepts
No ratings yet
Introduction to Cryptography Concepts
16 pages