_sopen_s, _wsopen_s

Öffnet eine Datei zur Freigabe. Diese Versionen von _sopen und _wsopen verfügen über Sicherheitsverbesserungen, wie in den Sicherheitsfeatures im CRT beschrieben.

Syntax

errno_t _sopen_s(
   int* pfh,
   const char *filename,
   int oflag,
   int shflag,
   int pmode
);
errno_t _wsopen_s(
   int* pfh,
   const wchar_t *filename,
   int oflag,
   int shflag,
   int pmode,
);

Parameter

pfh
Das Dateihandle oder -1, wenn ein Fehler auftritt.

filename
Dateiname.

oflag
Die zulässige Art von Vorgängen.

shflag
Die Art der zulässigen Freigabe.

pmode
Berechtigungseinstellung.

Rückgabewert

Ein Rückgabewert ungleich Null weist auf einen Fehler hin. In diesem Fall wird errno auf einen der folgenden Werte festgelegt.

Wenn ein ungültiges Argument an die Funktion übergeben wird, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die Ausführung fortgesetzt werden darf, errno wird sie auf EINVAL, und EINVAL wird zurückgegeben.

Weitere Informationen zu diesen und anderen Rückgabecodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno

Wenn ein Fehler auftritt, wird -1 zurückgegeben pfh (es sei denn, es handelt sich um pfh einen Nullzeiger).

Hinweise

Die Funktion _sopen_s öffnet die durch filename angegebene Datei und bereitet sie zur Lese- oder Schreibfreigabe vor, wie in oflag und shflag definiert. _wsopen_s ist eine Breitzeichenversion von _sopen_s. Das filename -Argument für _wsopen_s ist eine Breitzeichenfolge. _wsopen_s und _sopen_s verhalten sich andernfalls identisch.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern finden Sie im Global state in the CRT.

Mapping generischer Textroutinen

Der ganzzahlige Ausdruck oflag wird durch Kombinieren einer oder mehrerer Manifestkonstanten gebildet, die in <fcntl.h>definiert sind. Wenn zwei oder mehr Konstanten das Argument oflagbilden, werden sie mit dem bitweisen OR-Operator ( | ) kombiniert.

Zum Angeben des Dateizugriffsmodus müssen Sie _O_RDONLY, _O_RDWR oder _O_WRONLY angeben. Für den Zugriffsmodus gibt es keinen Standardwert.

Wenn eine Datei mit _O_WTEXT, _O_U8TEXT oder _O_U16TEXT im Unicode-Modus geöffnet wird, übersetzen die Eingabefunktionen die aus der Datei gelesenen Daten in UTF-16-Daten, die als Datentyp wchar_t gespeichert werden. Funktionen, die in eine im Unicode-Modus geöffnete Datei schreiben, erwarten Puffer, die UTF-16-Daten, die als Datentyp wchar_tgespeichert sind. Wenn die Datei als UTF-8 codiert ist, werden UTF-16-Daten beim Schreiben in UTF-8 übersetzt. Der UTF-8-codierte Inhalt der Datei wird beim Lesen in UTF-16 übersetzt. Der Versuch, eine ungerade Anzahl von Bytes im Unicode-Modus zu lesen oder zu schreiben, führt zu einem Parametervalidierungsfehler . Wenn Sie Daten lesen oder schreiben möchten, die in Ihrem Programm als UTF-8 gespeichert sind, verwenden Sie den Text- oder Binärdateienmodus anstelle eines Unicode-Modus. Sie sind für alle erforderlichen Codierungsübersetzungen verantwortlich.

Wenn _sopen_s mit _O_WRONLY | _O_APPEND (Anfügemodus) und _O_WTEXT,_O_U16TEXT oder _O_U8TEXT aufgerufen wird, versucht sie zuerst, die Datei zum Lesen und Schreiben zu öffnen, und dann, die BOM zu lesen und die Datei erneut, jedoch nur zum Schreiben, zu öffnen. Wenn das Öffnen der Datei zum Lesen und Schreiben fehlschlägt, wird die Datei nur zum Schreiben geöffnet und der Standardwert für die Unicode-Moduseinstellung verwendet.

Das Argument shflag ist ein konstanter Ausdruck, der aus einer der folgenden Manifestkonstanten besteht, die in <share.h>definiert sind.

Das Argument pmode ist immer erforderlich, im Gegensatz zu _sopen. Wenn Sie angeben _O_CREAT, wenn die Datei nicht vorhanden ist, pmode gibt die Berechtigungseinstellungen der Datei an, die festgelegt werden, wenn die neue Datei zum ersten Mal geschlossen wird. Andernfalls wird pmode ignoriert. pmode ist ein ganzzahliger Ausdruck, der eine oder beide der Manifestkonstanten _S_IWRITE _S_IREADund , die definiert sind, <sys\stat.h>enthält. Wenn beide Konstanten angegeben werden, werden sie mit dem bitweisen OR-Operator kombiniert. pmode hat folgende Bedeutung:

Wenn keine Schreibberechtigung erteilt wird, ist die Datei schreibgeschützt. Im Windows-Betriebssystem sind alle Dateien lesbar; Es ist nicht möglich, schreibgeschützte Berechtigungen zu erteilen. Deshalb sind die Modi _S_IWRITE und _S_IREAD | _S_IWRITE gleichwertig.

_sopen_s wendet die aktuelle Dateiberechtigungsmaske für pmode an, bevor die Berechtigungen festgelegt werden. (Siehe _umask.)

Anforderungen

_sopen_s und _wsopen_s sind Microsoft-Erweiterungen. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

Ein Beispiel hierfür finden Sie unter _locking.

Siehe auch

E/A auf niedriger Ebene
_close
_creat, _wcreat
fopen, _wfopen
_fsopen, _wfsopen
_open, _wopen