MsiSourceListSetInfoA-Funktion (msi.h)
Die MsiSourceListSetInfo-Funktion legt Informationen zur Quellliste für ein Produkt oder Einen Patch in einem bestimmten Kontext fest.
Syntax
UINT MsiSourceListSetInfoA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] LPCSTR szProperty,
[in] LPCSTR szValue
);
Parameter
[in] szProductCodeOrPatchCode
Die ProductCode - oder Patch-GUID des Produkts oder Patches. Verwenden Sie eine NULL-Zeichenfolge. Wenn die Zeichenfolge länger als 39 Zeichen ist, schlägt die Funktion fehl und gibt ERROR_INVALID_PARAMETER zurück. Dieser Parameter darf nicht NULL sein.
[in, optional] szUserSid
Bei diesem Parameter kann es sich um eine Zeichenfolgen-SID handeln, die das Benutzerkonto angibt, das das Produkt oder den Patch enthält. Die SID wird nicht überprüft oder aufgelöst. Eine falsche SID kann ERROR_UNKNOWN_PRODUCT oder ERROR_UNKNOWN_PATCH zurückgeben. Beim Verweisen auf einen Computerkontext muss szUserSIDNULL und dwContextMSIINSTALLCONTEXT_MACHINE sein.
[in] dwContext
Dieser Parameter gibt den Kontext des Produkt- oder Patch-instance an. Dieser Parameter kann einen der folgenden Werte enthalten.
[in] dwOptions
Der dwOptions-Wert gibt die Bedeutung von szProductCodeOrPatchCode an.
Wenn die festgelegte Eigenschaft "LastUsedSource" ist, gibt dieser Parameter auch den Typ der Quelle als Netzwerk oder URL an. In diesem Fall muss der dwOptions-Parameter eine Kombination aus einer der folgenden MSISOURCETYPE_ Konstanten und einer der folgenden MSICODE_ Konstanten sein.
[in] szProperty
Der Parameter szProperty gibt den festzulegenden Eigenschaftswert an. Nicht alle Eigenschaften, die über MsiSourceListGetInfo abgerufen werden können, können über einen Aufruf von MsiSourceListSetInfo festgelegt werden. Der szProperty-Wert kann einer der folgenden Werte sein.
| Name | Bedeutung |
|---|---|
|
Der Pfad relativ zum Stammverzeichnis des Installationsmediums. |
|
Die Vorlage für eine Aufforderung, über die die Benutzer*innen zum Bereitstellen von Installationsmedien aufgefordert werden. |
|
Der zuletzt verwendete Quellspeicherort für das Produkt. Wenn die Quelle nicht registriert ist, ruft die Funktion MsiSourceListAddSourceEx auf, um sie zu registrieren. Bei erfolgreicher Registrierung legt die Funktion die Quelle als LastUsedSource fest. |
|
Der Name des Windows Installer-Pakets oder des Patchpakets in der Quelle. |
[in] szValue
Der neue Wert der Eigenschaft. Es wird keine Überprüfung des neuen Werts durchgeführt. Dieser Wert darf nicht NULL sein. Es kann sich um eine leere Zeichenfolge handeln.
Rückgabewert
Die MsiSourceListSetInfo-Funktion gibt die folgenden Werte zurück.
| Wert | Bedeutung |
|---|---|
|
Der Benutzer kann die Quellliste für das angegebene Produkt nicht festlegen. |
|
Die Konfigurationsdaten sind beschädigt. |
|
Auf den Windows Installer-Dienst konnte nicht zugegriffen werden. |
|
Es wurde ein ungültiger Parameter an die Funktion übergeben. |
|
Die Eigenschaft wurde festgelegt. |
|
Der Patch wurde nicht gefunden. |
|
Das Produkt wurde nicht gefunden. |
|
Die Quelleigenschaft wurde nicht gefunden. |
|
Unerwarteter interner Fehler. |
Hinweise
Administratoren können die Installation eines Produkts oder Patch-instance ändern, das im Computerkontext oder unter ihrem eigenen Benutzerkontext (verwaltet oder nicht verwaltet) vorhanden ist. Sie können die Installation eines Produkts oder eines Patch-instance ändern, das unter dem benutzerspezifischen benutzerseitig verwalteten Kontext vorhanden ist. Administratoren können die Installation eines Produkts oder Patch-instance eines anderen Benutzers nicht ändern, der unter dem nicht verwalteten Kontext dieses anderen Benutzers vorhanden ist.
Nicht-Administratoren können die Installation eines Produkts oder Patch-instance nicht ändern, das unter dem Benutzerkontext eines anderen Benutzers (verwaltet oder nicht verwaltet) vorhanden ist. Sie können die Installation eines Produkts oder eines Patch-instance ändern, das unter ihrem eigenen benutzerspezifischen nicht verwalteten Kontext vorhanden ist. Sie können die Installation eines Produkts oder eines Patch-instance unter dem Computerkontext oder ihrem eigenen benutzerseitig verwalteten Kontext nur ändern, wenn sie für die Suche nach einem Produkt oder einer Patchquelle aktiviert sind. Benutzer können aktiviert werden, um nach Quellen zu suchen, indem Sie eine Richtlinie festlegen. Weitere Informationen finden Sie in den Richtlinien DisableBrowse, AllowLockdownBrowse und AlwaysInstallElevated .
Eine Ausnahme von der obigen Regel ist das Festlegen von "LastUsedSource" auf eine der registrierten Quellen. Wenn die Quelle bereits registriert ist, kann ein Nicht-Administrator "LastUsedSource" unabhängig von Richtlinien auf eigene Installationen (verwaltet oder nicht verwaltet) und Computerinstallationen festlegen.
Hinweis
Der msi.h-Header definiert MsiSourceListSetInfo als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | 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. Informationen zum minimal erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen. |
| Zielplattform | Windows |
| Kopfzeile | msi.h |
| Bibliothek | Msi.lib |
| DLL | Msi.dll |