Patch.SourceListAddSource-Methode

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

Syntax

Patch.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 das Installationsprogramm die Quelle am Ende der Quellliste hinzu.

Wenn diese Funktion mit einer Quelle aufgerufen wird, die bereits in der Quellliste vorhanden ist, und Index auf 0 festgelegt ist, behält das Installationsprogramm 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 (null) 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 als die Anzahl der Quellen in der Liste ist, 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_IPatch ist definiert als 000C10A1-0000-0000-C000-000000000046

Siehe auch

Patch

MsiSourceListAddSourceEx

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