MsiSourceListAddMediaDiskA-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 MsiSourceListAddMediaDiskA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] DWORD dwDiskId,
[in] LPCSTR szVolumeLabel,
[in, optional] LPCSTR szDiskPrompt
);
Parameter
[in] szProductCodeOrPatchCode
Die ProductCode - oder Patch-GUID des Produkts oder Patches. Verwenden Sie eine NULL-endende 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.
[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.
Flag | Bedeutung |
---|---|
|
szProductCodeOrPatchCode ist eine Produktcode-GUID. |
|
szProductCodeOrPatchCode ist eine Patchcode-GUID. |
[in] dwDiskId
Dieser Parameter gibt die ID des Datenträgers an, der hinzugefügt oder aktualisiert wird.
[in] szVolumeLabel
SzVolumeLabel stellt die Bezeichnung des Datenträgers bereit, der hinzugefügt oder aktualisiert wird. Ein Update überschreibt die vorhandene Datenträgerbezeichnung in der Registrierung. Um nur die Datenträgereingabeaufforderung zu ändern, rufen Sie die vorhandene Volumebezeichnung aus der Registrierung ab, und geben Sie sie in diesem Aufruf zusammen mit der neuen Datenträgereingabeaufforderung an. Beim Übergeben einer NULL-Zeichenfolge oder einer leeren Zeichenfolge für szVolumeLabel wird eine leere Zeichenfolge (0 Bytes lang) als Volumebeschriftung registriert.
[in, optional] szDiskPrompt
Beim Eintrag zu MsiSourceListAddMediaDisk gibt szDiskPrompt die Datenträgereingabeaufforderung des Datenträgers an, der hinzugefügt oder aktualisiert wird. Ein Update überschreibt die Eingabeaufforderung für den registrierten Datenträger.
Um nur die Volumebezeichnung zu ändern, rufen Sie die vorhandene Datenträgereingabeaufforderung ab, die registriert ist, und geben Sie sie an, wenn Sie MsiSourceListAddMediaDisk zusammen mit der neuen Volumebezeichnung aufrufen. Durch Übergeben von NULL oder einer leeren Zeichenfolge wird eine leere Zeichenfolge (0 Bytes lang) als Datenträgereingabeaufforderung registriert.
Rückgabewert
Die MsiSourceListAddMediaDisk-Funktion 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. |
|
Es wurde ein ungültiger Parameter an die Funktion übergeben. |
|
Der Wert wurde erfolgreich neu angeordnet. |
|
Der Patch wurde nicht gefunden. |
|
Das Produkt wurde nicht gefunden. |
|
Unerwarteter interner Fehler. |
Hinweise
Administratoren können die Installation eines Produkts oder eines 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, der im benutzerspezifischen verwalteten Kontext eines Benutzers vorhanden ist. Administratoren können die Installation eines Produkts oder eines Patch-instance eines anderen Benutzers, der unter dem benutzerspezifischen nicht verwalteten Kontext des anderen Benutzers vorhanden ist, nicht ändern.
Nicht-Administratoren können die Installation eines Produkts oder eines Patch-instance nicht ändern, der im Benutzerkontext eines anderen Benutzers (verwaltet oder nicht verwaltet) vorhanden ist. Sie können die Installation eines Produkts oder eines Patches instance ändern, das unter ihrem eigenen benutzerspezifischen nicht verwalteten Kontext vorhanden ist. Sie können die Installation eines Produkts oder 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 unter DisableBrowse, AllowLockdownBrowse, AllowLockDownMedia und AlwaysInstallElevated .
Hinweis
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
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. Windows Installer 3.0 oder höher unter Windows Server 2003 oder Windows XP. Informationen zum mindestens 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 |