DscFileSet.AddNewFile Method (UInt64, String)
Creates an entry for a new file with the specified size estimate in a DSC file set, and designates that DSC should store the file on the preferred compute node that you specify, if possible.
Namespace: Microsoft.Hpc.Dsc
Assembly: Microsoft.Hpc.Dsc (in Microsoft.Hpc.Dsc.dll)
Usage
'Usage
Dim instance As DscFileSet
Dim estimatedFileSizeInBytes As ULong
Dim preferredNodeName As String
Dim returnValue As DscFile
returnValue = instance.AddNewFile(estimatedFileSizeInBytes, preferredNodeName)
Syntax
'Declaration
Public Function AddNewFile ( _
estimatedFileSizeInBytes As ULong, _
preferredNodeName As String _
) As DscFile
public DscFile AddNewFile (
ulong estimatedFileSizeInBytes,
string preferredNodeName
)
public:
DscFile^ AddNewFile (
usigned long long estimatedFileSizeInBytes,
String^ preferredNodeName
)
public DscFile AddNewFile (
UInt64 estimatedFileSizeInBytes,
String preferredNodeName
)
public function AddNewFile (
estimatedFileSizeInBytes : ulong,
preferredNodeName : String
) : DscFile
Parameters
- estimatedFileSizeInBytes
An unsigned long integer that specifies the estimated final size in bytes of the DSC file that you want to add to the file set.
- preferredNodeName
A String that specifies the name of the compute node that you on which you prefer to store the new DSC file.
Return Value
A DscFile that represents the new DSC file.
Remarks
To add an entry for a new DSC file without specifying a preferred compute node on which to store the DSC file, use the AddNewFile(UInt64) form of the method.
You cannot add new files to a file set after you call the Seal method to finalize the data in the file set.
Platform Note: This method was introduced in Windows HPC Server 2008 R2 with Service Pack 2 (SP2) and is not supported in previous versions.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Platforms
Development Platforms
Windows XP, Windows Vista, Windows 7, Windows 8, Windows Server 2003, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012
Target Platforms
Windows XP, Windows Vista, Windows 7, Windows Server 2003, Windows Server 2003 R2, Windows Server 2008, Windows Server 2008 R2, with HPC Pack Client Utilities
See Also
Reference
DscFileSet Class
DscFileSet Members
Microsoft.Hpc.Dsc Namespace
AddNewFile(UInt64)
DscFile
AddExistingFile
GetFiles
Seal
Build Date:
2013-04-22