Share via


Patch.SourceListAddSource-Methode

Die SourceListAddSource-Methode fügt eine Netzwerk- oder URL-Quelle hinzu. Sie akzeptiert SourcePath, Type und Index als Parameter. Diese Methode ruft MsiSourceListAddSourceEx auf.

Syntax

Product.SourceListAddSource(
  Type,
  SourcePath,
  Index
)

Parameter

Typ

Typ der Quelle, die hinzugefügt werden soll: MSISOURCETYPE_NETWORK oder MSISOURCETYPE_URL.

SourcePath

Pfad zur Quelle, die hinzugefügt werden soll.

Index

Wenn SourceListAddSource mit einer neuen Quelle aufgerufen wird und Index auf 0 festgelegt ist, fügt der Installer die Quelle am Ende der Quellenliste hinzu.

Wenn diese Funktion mit einer Quelle aufgerufen wird, die bereits in der Quellenliste vorhanden ist, und Index auf 0 festgelegt ist, behält der Installer den vorhandenen Index der Quelle bei.

Wenn die Funktion mit einer vorhandenen Quelle in der Quellenliste aufgerufen wird und Index auf einen Wert ungleich 0 festgelegt ist, wird die Quelle von ihrer aktuellen Position in der Liste entfernt und an der durch Index angegebenen Position vor einer Quelle eingefügt, die bereits an dieser Position vorhanden ist.

Wenn die Funktion mit einer neuen Quelle aufgerufen wird und Index auf einen Wert ungleich 0 festgelegt ist, wird die Quelle an der durch Index angegebenen Position vor einer Quelle eingefügt, die bereits an dieser Position vorhanden ist. Der Indexwert für alle Quellen in der Liste nach dem durch Index angegebenen Index wird aktualisiert, damit die Indexwerte eindeutig sind und die bereits vorhandene Reihenfolge garantiert unverändert bleibt.

Wenn Index größer ist als die Anzahl der Quellen in der Liste, wird die Quelle am Ende der Liste mit einem Indexwert platziert, der um eins größer ist als der aller vorhandenen Quellen.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Anforderungen

Anforderung Wert
Version
Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer 3.0 oder höher unter Windows Server 2003, Windows XP oder Windows 2000
DLL
Msi.dll
IID
IID_IProduct ist definiert als 000C10A0-0000-0000-C000-000000000046

Siehe auch

Product

MsiSourceListAddSourceEx

Von Windows Installer 2.0 und früheren Versionen nicht unterstützt