MsiSourceListSetInfoA-Funktion (msi.h)
Die MsiSourceListSetInfo-Funktion legt Informationen zur Quellliste für ein Produkt oder 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 mit Null beendete Zeichenfolge. Wenn die Zeichenfolge länger als 39 Zeichen ist, schlägt die Funktion fehl und gibt ERROR_INVALID_PARAMETERzurück. Dieser Parameter kann nicht NULL-werden.
[in, optional] szUserSid
Dieser Parameter kann eine Zeichenfolgen-SID sein, 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_PATCHzurückgeben. Beim Verweisen auf einen Computerkontext muss szUserSID-NULL- sein und dwContext-MSIINSTALLCONTEXT_MACHINEsein.
[in] dwContext
Dieser Parameter gibt den Kontext der Produkt- oder Patchinstanz an. Dieser Parameter kann einen der folgenden Werte enthalten.
[in] dwOptions
Der wert dwOptions gibt die Bedeutung szProductCodeOrPatchCodean.
Wenn die festgelegte Eigenschaft "LastUsedSource" lautet, gibt dieser Parameter auch den Quelltyp 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 MsiSourceListSetInfofestgelegt werden. Der szProperty Wert kann einer der folgenden Werte sein.
| Name | Bedeutung |
|---|---|
|
Der Pfad relativ zum Stammverzeichnis des Installationsmediums. |
|
Die Eingabeaufforderungsvorlage, die verwendet wird, wenn der Benutzer zur Eingabe von Installationsmedien aufgefordert wird. |
|
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 Patchpakets in der Quelle. |
[in] szValue
Der neue Wert der Eigenschaft. Es wird keine Überprüfung des neuen Werts ausgeführt. Dieser Wert kann nicht NULL-werden. Dies kann eine leere Zeichenfolge sein.
Rückgabewert
Die MsiSourceListSetInfo Funktion gibt die folgenden Werte zurück.
| Wert | Bedeutung |
|---|---|
|
Der Benutzer hat nicht die Möglichkeit, die Quellliste für das angegebene Produkt festzulegen. |
|
Die Konfigurationsdaten sind beschädigt. |
|
Auf den Windows Installer-Dienst konnte nicht zugegriffen werden. |
|
An die Funktion wurde ein ungültiger Parameter übergeben. |
|
Die Eigenschaft wurde festgelegt. |
|
Der Patch wurde nicht gefunden. |
|
Das Produkt wurde nicht gefunden. |
|
Die Quelleigenschaft wurde nicht gefunden. |
|
Unerwarteter interner Fehler. |
Bemerkungen
Administratoren können die Installation eines Produkts oder einer Patchinstanz ändern, die im Computerkontext oder im eigenen Benutzerkontext vorhanden ist (verwaltet oder nicht verwaltet).) Sie können die Installation eines Produkts oder einer Patchinstanz ändern, die im vom Benutzer verwalteten Kontext vorhanden ist. Administratoren können die Installation eines Produkts oder einer Patchinstanz eines anderen Benutzers nicht ändern, die im kontextbasierten Kontext eines anderen Benutzers vorhanden ist.
Nicht-Administratoren können die Installation eines Produkts oder einer Patchinstanz nicht ändern, die im Benutzerkontext eines anderen Benutzers vorhanden ist (verwaltet oder nicht verwaltet.) Sie können die Installation eines Produkts oder einer Patchinstanz ändern, die unter ihrem eigenen benutzerspezifischen nicht verwalteten Kontext vorhanden ist. Sie können die Installation eines Produkts oder einer Patchinstanz im Computerkontext oder in ihrem eigenen vom Benutzer verwalteten Kontext nur ändern, wenn sie für die Suche nach einer Produkt- oder Patchquelle aktiviert sind. Benutzer können aktiviert werden, um nach Quellen zu suchen, indem Sie eine Richtlinie festlegen. Weitere Informationen finden Sie unter DisableBrowse, AllowLockdownBrowseund AlwaysInstallElevated Richtlinien.
Eine Ausnahme der oben genannten Regel ist das Festlegen von "LastUsedSource" auf eine der registrierten Quellen. Wenn die Quelle bereits registriert ist, kann ein Nichtadministrator "LastUsedSource" unabhängig von richtlinienunabhängig auf eigene Installationen (verwaltet oder nicht verwaltet) festlegen.
Anmerkung
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 Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte 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 mindestens von einer Windows Installer-Version erforderlichen Windows-Service Pack finden Sie unter den Windows Installer-Run-Time Anforderungen. |
| Zielplattform- | Fenster |
| Header- | msi.h |
| Library | Msi.lib |
| DLL- | Msi.dll |
Siehe auch
in Windows Installer 2.0 und früheren nicht unterstützt