_sopen_s, _wsopen_s

Öppnar en fil för delning. Dessa versioner av _sopen och _wsopen har säkerhetsförbättringar, enligt beskrivningen i Säkerhetsfunktioner i CRT-.

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
);

Parameterar

pfh
Filhandtaget eller -1 om det finns ett fel.

filename
Filnamn.

oflag
Den typ av åtgärder som tillåts.

shflag
Den typ av delning som tillåts.

pmode
Behörighetsinställning.

Returvärde

Ett nonzero-returvärde anger ett fel. i så fall errno anges till något av följande värden.

Om ett ogiltigt argument skickas till funktionen anropas den ogiltiga parameterhanteraren enligt beskrivningen i Parameterverifiering. Om körningen tillåts fortsätta anges errno till EINVALoch EINVAL returneras.

Mer information om dessa och andra returkoder finns i errno, _doserrno, _sys_errlistoch _sys_nerr.

Om det uppstår ett fel returneras -1 genom pfh (såvida inte pfh är en null-pekare).

Anmärkningar

Funktionen _sopen_s öppnar filen som anges av filename och förbereder filen för delad läsning eller skrivning, enligt definitionen av oflag och shflag. _wsopen_s är en bred teckenversion av _sopen_s; filename argumentet till _wsopen_s är en sträng med många tecken. _wsopen_s och _sopen_s beter sig identiskt annars.

Som standard är den här funktionens globala tillstånd begränsat till programmet. Information om hur du ändrar det finns i Globalt tillstånd i CRT-.

Allmän textrutinmappning

Heltalsuttrycket oflag skapas genom att en eller flera manifestkonstanter kombineras, som definieras i <fcntl.h>. När två eller flera konstanter utgör argumentet oflagkombineras de med bitwise-OR-operatorn ( | ).

Om du vill ange filåtkomstläget måste du ange antingen _O_RDONLY, _O_RDWReller _O_WRONLY. Det finns inget standardvärde för åtkomstläget.

När en fil öppnas i Unicode-läge med hjälp _O_WTEXTav indatafunktionerna , _O_U8TEXTeller _O_U16TEXTöversätter indata som läses från filen till UTF-16-data som lagras som typ wchar_t. Funktioner som skriver till en fil som öppnas i Unicode-läge förväntar sig buffertar som innehåller UTF-16-data som lagras som typ wchar_t. Om filen kodas som UTF-8 översätts UTF-16-data till UTF-8 när den skrivs. Filens UTF-8-kodade innehåll översätts till UTF-16 när den läses. Ett försök att läsa eller skriva ett udda antal byte i Unicode-läge orsakar ett parameterverifieringsfel. Om du vill läsa eller skriva data som lagras i programmet som UTF-8 använder du ett text- eller binärfilläge i stället för ett Unicode-läge. Du ansvarar för all nödvändig kodningsöversättning.

Om _sopen_s anropas med _O_WRONLY | _O_APPEND (tilläggsläge) och _O_WTEXT, _O_U16TEXTeller _O_U8TEXT, försöker den först öppna filen för att läsa och skriva, läsa bommen och sedan öppna den för endast skrivning. Om det inte går att öppna filen för läsning och skrivning öppnas filen endast för skrivning och använder standardvärdet för unicode-lägesinställningen.

Argumentet shflag är ett konstant uttryck som består av en av följande manifestkonstanter, som definieras i <share.h>.

Argumentet pmode krävs alltid, till skillnad från i _sopen. När du anger _O_CREATanger , om filen inte finns, pmode filens behörighetsinställningar, som anges när den nya filen stängs första gången. Annars pmode ignoreras. pmode är ett heltalsuttryck som innehåller en eller båda manifestkonstanterna _S_IWRITE och _S_IREAD, som definieras i <sys\stat.h>. När båda konstanterna anges kombineras de med bitwise-OR-operatorn. Innebörden av pmode är följande.

Om skrivbehörighet inte ges är filen skrivskyddad. I Windows-operativsystemet är alla filer läsbara. det går inte att ge skrivskyddad behörighet. Därför är lägena _S_IWRITE och _S_IREAD | _S_IWRITE likvärdiga.

_sopen_s tillämpar den aktuella filbehörighetsmasken pmode på innan behörigheterna anges. (Se _umask.)

Kravspecifikation

_sopen_s och _wsopen_s är Microsoft-tillägg. Mer kompatibilitetsinformation finns i Kompatibilitet.

Exempel

Se exemplet för _locking.

Se även

Lågnivå-I/O
_close
_creat, _wcreat
fopen, _wfopen
_fsopen, _wfsopen
_open, _wopen