大网数据广告活动
Hyper-V与虚拟化

Msvm_CopyFileToGuestSettingData class

· 52CE 我爱测

Represents the parameters for copying a file from the host into the guest.

Represents the parameters for copying a file from the host into the guest. This class derives from CIM_SettingData.

The following syntax is simplified from MOF code and includes all inherited properties.

Syntax

[AMENDMENT]
class Msvm_CopyFileToGuestSettingData : CIM_SettingData
{
  string  Description;
  string  Caption;
  string  InstanceID;
  string  ElementName;
  boolean OverwriteExisting;
  boolean CreateFullPath;
  string  SourcePath;
  string  DestinationPath;
};

Members

The Msvm_CopyFileToGuestSettingData class has these types of members:

Properties

The Msvm_CopyFileToGuestSettingData class has these properties.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen ( 64 )

A short textual description of the object.

CreateFullPath

Data type: boolean

Access type: Read-only

Indicates whether missing directories in the destination file's path must be created before copying the file.

Description

Data type: string

Access type: Read-only

A textual description of the object.

DestinationPath

Data type: string

Access type: Read-only

The complete path of the destination file to be copied. This destination file must be accessible to the guest and can contain environment variables, which are expanded by the guest. If the path specified is an existing directory in the guest, the destination file is created in this directory. In this case, the file name from SourcePath is used as the destination file name.

ElementName

Data type: string

Access type: Read-only

The display name for this instance of SettingData. In addition, the display name can be used as an index property for a search or query. (Note: The name does not have to be unique within a namespace.)

InstanceID

Data type: string

Access type: Read-only

Qualifiers: Key

Within the scope of the instantiating Namespace, InstanceID opaquely and uniquely identifies an instance of this class. To ensure uniqueness within the NameSpace, the value of InstanceID should be constructed using the following "preferred" algorithm: OrgID:LocalID Where OrgID and LocalID are separated by a colon (:), and where OrgID must include a copyrighted, trademarked, or otherwise unique name that is owned by the business entity that is creating or defining the InstanceID or that is a registered ID assigned to the business entity by a recognized global authority. (This requirement is similar to the SchemaName_ClassName structure of Schema class names.) In addition, to ensure uniqueness, OrgID must not contain a colon (:). When using this algorithm, the first colon to appear in InstanceID must appear between OrgID and LocalID. LocalID is chosen by the business entity and should not be reused to identify different underlying (real-world) elements. If the above preferred algorithm is not used, the defining entity must assure that the resulting InstanceID is not reused across any InstanceIDs produced by this or other providers for the NameSpace of this instance. For DMTF-defined instances, the "preferred" algorithm must be used with the OrgID set to CIM.

OverwriteExisting

Data type: boolean

Access type: Read-only

Indicates whether an existing destination file must be overwritten.

SourcePath

Data type: string

Access type: Read-only

The complete path of the source file to be copied. This source file must be accessible to the Hyper-V host and can contain environment variables, which are expanded by the Hyper-V host.

Requirements

Requirement Value
Minimum supported client Windows 8.1 [desktop apps only]
Minimum supported server Windows Server 2012 R2 [desktop apps only]
Namespace Root\Virtualization\V2
MOF WindowsVirtualization.V2.mof
DLL Vmms.exe

See also

CIM_SettingData

CIM_SettingData

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。