Función SetupSetFileQueueAlternatePlatformW (setupapi.h)

[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. SetupAPI ya no debe usarse para instalar aplicaciones. En su lugar, use Windows Installer para desarrollar instaladores de aplicaciones. SetupAPI sigue utilizándose para instalar controladores de dispositivo.

La función SetupSetFileQueueAlternatePlatform asocia la cola de archivos a una plataforma de destino diferente de la plataforma que ejecuta la función. Esto se hace para habilitar la comprobación de firmas no nativas.

Sintaxis

WINSETUPAPI BOOL SetupSetFileQueueAlternatePlatformW(
  [in] HSPFILEQ             QueueHandle,
  [in] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [in] PCWSTR               AlternateDefaultCatalogFile
);

Parámetros

[in] QueueHandle

Identificador de una cola de archivos de configuración abierta.

[in] AlternatePlatformInfo

Puntero opcional a una estructura de SP_ALTPLATFORM_INFO pasando información sobre la plataforma alternativa. En Windows 2000, el miembro cbSize de esta estructura debe establecerse en sizeof(SP_ALTPLATFORM_INFO_V1). En Windows Server 2003 o Windows XP, el miembro cbSize de esta estructura debe establecerse en sizeof(SP_ALTPLATFORM_INFO_V2).

[in] AlternateDefaultCatalogFile

Puntero a una cadena terminada en null que especifica un catálogo que valida los archivos INF. Este parámetro puede ser NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Nota

El encabezado setupapi.h define SetupSetFileQueueAlternatePlatform como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	setupapi.h
Library	Setupapi.lib
Archivo DLL	Setupapi.dll

Vea también

Funciones

Información general

SP_ALTPLATFORM_INFO_V1

SP_ALTPLATFORM_INFO_V2