Return Values

The DirectXSetup function can return the following values. It can also return a standard COM error.

DSETUPERR_SUCCESS

Setup was successful and no restart is required.

DSETUPERR_SUCCESS_RESTART

Setup was successful and a restart is required.

DSETUPERR_BADSOURCESIZE

A file's size could not be verified or was incorrect.

DSETUPERR_BADSOURCETIME

A file's date and time could not be verified or were incorrect.

DSETUPERR_BADWINDOWSVERSION

Microsoft® DirectX® does not support the Microsoft® Windows® version on the system.

DSETUPERR_CANTFINDDIR

The setup program could not find the working directory.

DSETUPERR_CANTFINDINF

A required .inf file could not be found.

DSETUPERR_INTERNAL

An internal error occurred.

DSETUPERR_NEWERVERSION

A later version of DirectX has already been installed. Applications can safely ignore this error because the newer version is not overwritten and is fully compatible with applications written for earlier versions.

DSETUPERR_NOTADMIN

The current user does not have administrative privileges. On Windows 2000 systems, the user may need administrative privileges for some setup operations.

DSETUPERR_NOCOPY

A file's version could not be verified or was incorrect.

DSETUPERR_NOTPREINSTALLEDONNT

The version of Microsoft® Windows NT® or Windows 2000 on the system does not contain the current version of DirectX. An older version of DirectX might be present or DirectX might be absent altogether.

DSETUPERR_OUTOFDISKSPACE

The setup program ran out of disk space during installation.

DSETUPERR_SOURCEFILENOTFOUND

One of the required source files could not be found.

DSETUPERR_UNKNOWNOS

The operating system on your system is not currently supported.

DSETUPERR_UNSUPPORTEDPROCESSOR

The processor type is unsupported. DirectX 8 supports only Pentium or K6-compatible or higher processors.

DSETUPERR_USERHITCANCEL

The Cancel button was pressed before the application was fully installed.