SetupSetFileQueueAlternatePlatform function

[This function is available for use in the operating systems indicated in the Requirements section. It may be altered or unavailable in subsequent versions. SetupAPI should no longer be used for installing applications. Instead, use the Windows Installer for developing application installers. SetupAPI continues to be used for installing device drivers.]

The SetupSetFileQueueAlternatePlatform function associates the file queue with a target platform that is different from the platform running the function. This is done to enable for non-native signature verification.

Syntax


BOOL SetupSetFileQueueAlternatePlatform(
  _In_ HSPFILEQ             QueueHandle,
  _In_ PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  _In_ PCWSTR               AlternateDefaultCatalogFile
);

Parameters

QueueHandle [in]

Handle to an open setup file queue.

AlternatePlatformInfo [in]

Optional pointer to an SP_ALTPLATFORM_INFO structure passing information about the alternate platform. On Windows 2000, the cbSize member of this structure must be set to sizeof(SP_ALTPLATFORM_INFO_V1). On Windows Server 2003 or Windows XP, the cbSize member of this structure must be set to sizeof(SP_ALTPLATFORM_INFO_V2).

AlternateDefaultCatalogFile [in]

Pointer to a null-terminated string that specifies a catalog that validates any INF files. This parameter may be NULL.

Return value

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Setupapi.h

Library

Setupapi.lib

DLL

Setupapi.dll

Unicode and ANSI names

SetupSetFileQueueAlternatePlatformW (Unicode) and SetupSetFileQueueAlternatePlatformA (ANSI)

See also

Overview
Functions
SP_ALTPLATFORM_INFO_V1
SP_ALTPLATFORM_INFO_V2

 

 

Show: