Share via


MsiRecordSetStreamW-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 MsiRecordSetStreamW(
  [in] MSIHANDLE hRecord,
  [in] UINT      iField,
  [in] LPCWSTR   szFilePath
);

Parameter

[in] hRecord

Handle mit dem Datensatz.

[in] iField

Gibt das Feld des festzulegenden Datensatzes an.

[in] szFilePath

Gibt den Pfad zur 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 bleibt erhalten, wenn der Datensatz in die Datenbank eingefügt und die Datenbank committet 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 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

   
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

Weitere Informationen

Datensatzverarbeitungsfunktionen