MsiRecordSetStreamA-Funktion (msiquery.h)

  • Artikel

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

Weitere Informationen

Datensatzverarbeitungsfunktionen