DaVinci 4: DaVinci Funktion ipCreateStreamOnFile: IStream-Interface für Datei erzeugen

Die Funktion ipCreateStreamOnFile öffnet eine Datei und erzeugt ein neues Objekt mit IStream Interface.

HRESULT WINAPI ipCreateStreamFile (
	LPCTSTR pcszFileName,
	DWORD grfMode,
	IStream **ppstm);

pcszFileName	LPCTSTR	Dateiname der zu öffnenden Datei.
grfMode	DWORD	STGM_READ wenn das Objekt nur zum Lesen geöffnet wurde, sonst STGM_READWRITE.
ppstm	IStream **	Zeiger auf eine Variable vom Typ IStream *, die einen Zeiger auf das neu erzeugte Objekt erhalten wird.
Rückgabewert
Der Rückgabewert ist S_OK (0), wenn kein Fehler auftrat, E_OUTOFMEMORY, wenn das Objekt nicht erzeugt werden konnte und OleLastWin32Error() wenn ein anderer Fehler auftrat.
Anmerkungen
Diese Funktion ist semantisch identisch der Windows API-Funktion SHCreateStreamOnFile. Leider ist SHCreateStreamOnFile aber in Internet Explorer 5 fehlerhaft implementiert, weshalb in DaVinci 4 diese eigene Implementierung zur Verfügung gestellt wird. Für 64-Bit Windows ruft diese Funktion unmittelbar SHCreateStreamOnFile auf.
Das neu erzeugte Objekt mit IStream Interface muss durch Aufruf seiner Release()-Methode freigegeben werden.
→ ipImportInd
→ Datenquellen und Datensenken (Streams)
→ Struktur DAVPARAMS

Rückgabewert