MsiRecordSetStreamA-Funktion (msiquery.h)
Die MsiRecordSetStream-Funktion legt ein Datensatzdatenstromfeld aus einer Datei fest. Datenstromdaten können nicht in temporäre Felder eingefügt werden.
Syntax
UINT MsiRecordSetStreamA(
[in] MSIHANDLE hRecord,
[in] UINT iField,
[in] LPCSTR szFilePath
);
Parameter
[in] hRecord
Handle mit dem Datensatz.
[in] iField
Gibt das Feld des festzulegenden Datensatzes an.
[in] szFilePath
Gibt den Pfad zu der Datei an, die den Stream enthält.
Rückgabewert
Die MsiRecordSetStream-Funktion gibt die folgenden Werte zurück:
Hinweise
Der Inhalt der in der MsiRecordSetStream-Funktion angegebenen Datei wird in ein Streamobjekt eingelesen. Der Stream wird beibehalten, wenn der Datensatz in die Datenbank eingefügt und ein Commit für die Datenbank ausgeführt wird.
Um den Stream auf seinen Anfang zurückzusetzen, müssen Sie einen NULL-Zeiger für szFilePath übergeben. Übergeben Sie keinen Zeiger auf die leere Zeichenfolge "", um den Stream zurückzusetzen.
Siehe auch OLE-Einschränkungen für Streams.
Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe von MsiGetLastErrorRecord abrufen.
Hinweis
Der msiquery.h-Header definiert MsiRecordSetStream 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 |
|---|---|
| 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 unter Windows Server 2003 oder Windows XP |
| Zielplattform | Windows |
| Kopfzeile | msiquery.h |
| Bibliothek | Msi.lib |
| DLL | Msi.dll |