[IDL]
HRESULT CreateBootMedia(
	BSTR MediaType,
	 BSTR DestinationPath,
	 BSTR BootImageID,
	 VARIANT* MediaPassword,
	 VARIANT* CertPath,
	 VARIANT* CertPassword,
	 VARIANT* CertValidStart,
	 VARIANT* CertValidEnd,
	VARIANT_BOOL Async
);

Parameters

MediaType

Data type: BSTRQualifiers: [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 driver 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: BSTRQualifiers: [in]The output file or output drive.

BootImageID

Data type: BSTRQualifiers: [in]The boot image ID from the boot image catalog.

MediaPassword

Data type: VARIANTQualifiers: [in]Pointer to a password to use to encrypt the certificate and other sensitive information. Use null for no password.

CertPath

Data type: VARIANTQualifiers: [in]Pointer to the path to a file in PFX format containing the media certificate. Use null for no certificate.

CertPassword

Data type: VARIANTQualifiers: [in]Pointer to a password for the media certificate.

CertValidStart

Data type: VARIANTQualifiers: [in]Pointer to the time when a newly created certificate starts being valid.

CertValidEnd

Data type: VARIANTQualifiers: [in]Pointer to the time when the newly created certificate stops being valid.

Async

Data type: VARIANT_BOOLQualifiers: [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.

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.

Configuration Manager 2007.

Tasks

Reference

Other Resources