MsiSourceListAddMediaDiskW-Funktion (msi.h)
Die MsiSourceListAddMediaDisk Funktion fügt einen Datenträger der Medienquelle eines registrierten Produkts oder Patches hinzu oder aktualisiert sie. Wenn der angegebene Datenträger bereits vorhanden ist, wird er mit den neuen Werten aktualisiert. Wenn der angegebene Datenträger nicht vorhanden ist, wird ein neuer Datenträgereintrag mit den neuen Werten erstellt.
Syntax
UINT MsiSourceListAddMediaDiskW(
[in] LPCWSTR szProductCodeOrPatchCode,
[in, optional] LPCWSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] DWORD dwDiskId,
[in] LPCWSTR szVolumeLabel,
[in, optional] LPCWSTR szDiskPrompt
);
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_PARAMETER zurü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_PATCH zurückgeben.
[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.
| Flagge | Bedeutung |
|---|---|
|
szProductCodeOrPatchCode ist eine Produktcode-GUID. |
|
szProductCodeOrPatchCode ist eine Patchcode-GUID. |
[in] dwDiskId
Dieser Parameter stellt die ID des Datenträgers bereit, der hinzugefügt oder aktualisiert wird.
[in] szVolumeLabel
Die szVolumeLabel stellt die Bezeichnung des hinzugefügten oder aktualisierten Datenträgers bereit. Ein Update überschreibt die vorhandene Volumebezeichnung in der Registrierung. Um die Datenträgeraufforderung nur zu ändern, rufen Sie die vorhandene Volumebezeichnung aus der Registrierung ab, und geben Sie sie in diesem Aufruf zusammen mit der neuen Datenträgeraufforderung an. Durch Übergeben einer NULL- oder einer leeren Zeichenfolge für szVolumeLabel wird eine leere Zeichenfolge (0 Byte länge) als Volumebeschriftung registriert.
[in, optional] szDiskPrompt
Beim Eintrag in MsiSourceListAddMediaDiskstellt szDiskPrompt die Datenträgeraufforderung bereit, die hinzugefügt oder aktualisiert wird. Ein Update überschreibt die Aufforderung zum registrierten Datenträger.
Um die Volumebezeichnung nur zu ändern, rufen Sie die vorhandene Datenträgeraufforderung ab, die registriert ist, und geben Sie sie beim Aufrufen MsiSourceListAddMediaDisk zusammen mit der neuen Volumebezeichnung an. Durch Übergeben NULL- oder einer leeren Zeichenfolge wird eine leere Zeichenfolge (0 Byte länge) als Datenträgeraufforderung registriert.
Rückgabewert
Die funktion MsiSourceListAddMediaDisk gibt die folgenden Werte zurück.
| Wert | Bedeutung |
|---|---|
|
Der Benutzer hat nicht die Möglichkeit, die angegebene Medienquelle oder das angegebene Produkt oder Patch zu lesen. Dies gibt nicht an, ob eine Medienquelle, ein Produkt oder ein Patch gefunden wurde. |
|
Die Konfigurationsdaten sind beschädigt. |
|
Auf den Windows Installer-Dienst konnte nicht zugegriffen werden. |
|
An die Funktion wurde ein ungültiger Parameter übergeben. |
|
Der Wert wurde erfolgreich neu angeordnet. |
|
Der Patch wurde nicht gefunden. |
|
Das Produkt 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, AllowLockdownBrowse, AllowLockDownMedia und AlwaysInstallElevated Richtlinien.
Anmerkung
Der msi.h-Header definiert MsiSourceListAddMediaDisk 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. Windows Installer 3.0 oder höher unter Windows Server 2003 oder Windows XP. 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