ITsMediaClass::CreateStandaloneMedia Method

  • Article

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

In Configuration Manager, the CreateStandaloneMedia method creates stand-alone media from which to run your operating system image deployment. The stand-alone media will contain all necessary data to run the specified operating system deployment task sequences without requiring a connection to a Configuration Manager site.

[IDL]
HRESULT CreateStandaloneMedia(
   BSTR MediaType,
     BSTR DestinationPath,
     DWORD MediaSize,
     VARIANT* MediaPassword,
     BSTR TaskSequenceId,
     BSTR TaskSequenceVariables,
    VARIANT_BOOL Async
);

Parameters

  • MediaType
    Data type: BSTR

    Qualifiers: [in]

    The media type. Possible values are:

    CD

    A CD. The DestinationPath parameter should indicate a path where an ISO file can be created.

    UFD

    A drive. The DestinationPath parameter should indicate the drive letter of a USB Thumb Drive in the format "X:\"

    UFD+FORMAT

    A formatted drive. The DestinationPath parameter should indicate a drive letter, in the format "X:\". The drive will be formatted and made bootable. This media type is supported on the Windows Vista operating system only.

  • DestinationPath
    Data type: BSTR

    Qualifiers: [in]

    The output file or output drive.

  • MediaSize
    Data type: DWORD

    Qualifiers: [in]

    Size, in megabytes, of the output media.

  • MediaPassword
    Data type: VARIANT

    Qualifiers: [in]

    Pointer to a password to use to encrypt the certificate and other sensitive information. Use null for no password.

  • TaskSequenceId
    Data type: BSTR

    Qualifiers: [in]

    The ID of the task sequence.

  • TaskSequenceVariables
    Data type: BSTR

    Qualifiers: [in]

    Task sequence variables defined for the media. The strings should be name and value pairs in the format "name1=value1,name2=value2".

  • Async
    Data type: VARIANT_BOOL

    Qualifiers: [in, defaultvalue(0)]

    true if the creation process is asynchronous. In this case, the caller should poll until the value of ITsMediaClass::Status Property is 0 and then obtain the return value from ITsMediaClass::ExitCode Property.

    Set this parameter to false for synchronous media creation. See the Return Values section in this topic.

Return Values

An HRESULT code. Possible values include, but are not limited to the following value.

  • S_OK
    The method succeeded.

If the Async parameter is false and the media creation process is synchronous, the method can return the following error codes.

  • CREATETSMEDIA_E_NODEFAULTMP (0x80040001)
    A default management point has not been assigned for this site.
  • CREATETSMEDIA_E_NOMPCERTS (0x80040002)
    Certificates for the default management point are not available (internal error).
  • CREATETSMEDIA_E_MISSINGPACKAGE (0x80040003)
    Package {0} is not available on the specified distribution points.
  • CREATETSMEDIA_E_CERTPASSWORD (0x80040004)
    Invalid password for media certificate.
  • CREATETSMEDIA_E_PRIVATEKEY (0x80040005)
    The media certificate does not have an associated private key.
  • CREATETSMEDIA_E_NOCACERT (0x80040006)
    The certification authority’s certificate has not been set for this site.
  • CREATETSMEDIA_E_NOSITESIGNCERT (0x80040007)
    The certification authority’s certificate has not been set for this site.
  • CREATETSMEDIA_E_CONNECTIONOPTIONS (0x80040008)
    Invalid connection options (Configuration Manager SDK only).
  • CREATETSMEDIA_E_CONNECTIONOPTIONNAME (0x80040009)
    Invalid name for connection option {0} (Configuration Manager SDK only).
  • CREATETSMEDIA_E_UFD_FS_FAT16 (0x8004000A)
    The specified volume is formatted as FAT16, which is not supported. The file system must be FAT32 or NTFS.
  • CREATETSMEDIA_E_UFD_FS_UNKNOWN (0x8004000B)
    The specified volume has an unknown file system. The file system must be FAT32 or NTFS.
  • CREATETSMEDIA_E_PACKAGETOOLARGE (0x8004000C)
    Package {0} is too large to fit on the target media.

Note

Errors that include {0} in the description will have the corresponding value in ITsMediaClass::ErrorDetail Property.

Remarks

Standalone media are self-contained, and do not require a connection to a Configuration Manager site. All policies, package content, and the like are written on the media. For more information, see How to Create Stand-Alone Operating System Media.

Warning

ITsMediaClass::CreateBootMedia Method can fail if run concurrently with ITsMediaClass::CreateCaptureMedia Method or ITsMediaClass::CreateStandaloneMedia, To avoid this situation, your application should call ITsMediaClass::CreateBootMedia, ITsMediaClass::CreateCaptureMedia and ITsMediaClass::CreateStandaloneMedia by using the same.

Requirements

Configuration Manager 2007.

See Also

Concepts

ITsMediaClass Interface
ITsMediaClass::ExitCode Property
ITsMediaClass::Status Property
About Operating System Deployment Media Management
How to Create Stand-Alone Operating System Media