CIM_CopyFileAction class

The CIM_CopyFileAction class represents moving or copying files from a computer system to a new location.

Location information for copying is specified by using either the CIM_ToDirectorySpecification and CIM_FromDirectorySpecification associations, or the CIM_ToDirectoryAction and CIM_FromDirectoryAction associations. The first set is used when the source or target are to exist before any actions are taken. The second set is used when the source or target are created as a part of a previous action. In the latter case, the action to create the directory must occur prior to the CIM_CopyFileAction object.

Important

The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

[UUID("{73553260-DB22-11d2-85FC-0000F8102E5F}"), abstract, AMENDMENT]
class CIM_CopyFileAction : CIM_FileAction
{
  string  ActionID;
  string  Caption;
  string  Description;
  uint16  Direction;
  string  Name;
  string  SoftwareElementID;
  uint16  SoftwareElementState;
  uint16  TargetOperatingSystem;
  string  Version;
  boolean DeleteAfterCopy;
  string  Destination;
  string  Source;
};

Members

The CIM_CopyFileAction class has these types of members:

• Methods
• Properties

Methods

The CIM_CopyFileAction class has these methods.

Method	Description
Invoke	Takes a particular action. The details of how the method performs the action are implementation-specific. Not implemented by WMI.

Properties

The CIM_CopyFileAction class has these properties.

ActionID

Data type: string

Access type: Read-only

Qualifiers: key, maxlen (256)

Unique identifier assigned to a particular action for a software element.

This property is inherited from CIM_Action.

Caption

Data type: string

Access type: Read-only

Qualifiers: maxlen (64)

Short textual description of the object.

This property is inherited from CIM_Action.

DeleteAfterCopy

Data type: boolean

Access type: Read-only

If TRUE, the source file is deleted after the copy operation.

Description

Data type: string

Access type: Read-only

Description of the object.

This property is inherited from CIM_Action.

Destination

Data type: string

Access type: Read-only

Qualifiers: maxlen (1024)

Fully qualified destination file name.

Direction

Data type: uint16

Access type: Read-only

Indicates whether a particular CIM_Action object is part of a sequence of actions to transition the current software element to its next state, such as "Install", or to remove the current software element, such as "Uninstall".

This property is inherited from CIM_Action.

Install (0)

Uninstall (1)

Name

Data type: string

Access type: Read-only

Qualifiers: Propagated ("CIM_SoftwareElement.Name"), CIM_key, maxlen (256)

Identifies the software element.

This property is inherited from CIM_Action.

SoftwareElementID

Data type: string

Access type: Read-only

Qualifiers: Propagated ("CIM_SoftwareElement.SoftwareElementID"), CIM_key, maxlen (256)

Identifier for the software element.

This property is inherited from CIM_Action.

SoftwareElementState

Data type: uint16

Access type: Read-only

Qualifiers: Propagated ("CIM_SoftwareElement.SoftwareElementState"), CIM_key

State of a software element.

This property is inherited from CIM_Action.

Deployable (0)

Describes the details necessary for successful distribution and the details (conditions and actions) required to create a software element in the installable state (that is, the next state).

Installable (1)

Describes the details necessary for successful installation and the details (conditions and actions) required to create a software element in the executable state (that is, the next state).

Executable (2)

Describes the details necessary for successful execution and the details (conditions and actions) required to create a software element in the running state (that is, the next state).

Running (3)

Describes the details necessary to monitor and operate on a start element.

Source

Data type: string

Access type: Read-only

Qualifiers: maxlen (1024)

Fully qualified source file name.

TargetOperatingSystem

Data type: uint16

Access type: Read-only

Qualifiers: Propagated ("CIM_SoftwareElement.TargetOperatingSystem"), CIM_key, Mappingstrings ("MIF.DMTF|Software Component Information|002.5")

Target operating system of the owning software element.

This property is inherited from CIM_Action.

Unknown (0)

Other (1)

MACOS (2)

Mac OS

ATTUNIX (3)

DGUX (4)

DECNT (5)

Digital Unix (6)

OpenVMS (7)

Open VMS

HPUX (8)

HP-UX

AIX (9)

MVS (10)

OS400 (11)

OS/2 (12)

JavaVM (13)

Microsoft Virtual Machine (VM) for Java

MSDOS (14)

WIN3x (15)

Windows 3.x

WIN95 (16)

Windows 95

WIN98 (17)

Windows 98

WINNT (18)

Windows NT

WINCE (19)

Windows CE

NCR3000 (20)

NCR 3000

NetWare (21)

OSF (22)

DC/OS (23)

Reliant UNIX (24)

SCO UnixWare (25)

SCO OpenServer (26)

Sequent (27)

IRIX (28)

Solaris (29)

SunOS (30)

U6000 (31)

ASERIES (32)

A Series

TandemNSK (33)

Tandem NSK

TandemNT (34)

Tandem NT

BS2000 (35)

BS2000/OSD

LINUX (36)

Lynx (37)

XENIX (38)

VM/ESA (39)

Interactive UNIX (40)

BSDUNIX (41)

BSD UNIX

FreeBSD (42)

NetBSD (43)

GNU Hurd (44)

OS9 (45)

Mac OS 9

MACH Kernel (46)

Inferno (47)

QNX (48)

EPOC (49)

IxWorks (50)

VxWorks (51)

MiNT (52)

BeOS (53)

Be OS

HP MPE (54)

NextStep (55)

PalmPilot (56)

Palm OS

Rhapsody (57)

Windows 2000 (58)

Dedicated (59)

VSE (60)

TPF (61)

Version

Data type: string

Access type: Read-only

Qualifiers: Propagated ("CIM_SoftwareElement.Version"), CIM_key, Maxlen (64), Mappingstrings ("MIF.DMTF|ComponentID|001.3")

Version of the operation.

The version of the operation should be in one of the following forms:

• <major>.<minor>.<revision>
• <major>.<minor><letter><revision>

This property is inherited from CIM_Action.

Remarks

The CIM_CopyFileAction class is derived from CIM_FileAction.

WMI does not implement this class. For more information about classes derived from CIM_CopyFileAction, see Win32 Classes.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

See also

CIM_FileAction