_sopen, _wsopen

Hiermee opent u een bestand voor delen. Veiligere versies van deze functies zijn beschikbaar: zie _sopen_s, _wsopen_s.

Syntaxis

int _sopen(
   const char *filename,
   int oflag,
   int shflag [,
   int pmode ]
);
int _wsopen(
   const wchar_t *filename,
   int oflag,
   int shflag [,
   int pmode ]
);

Parameterwaarden

filename
Bestandsnaam.

oflag
Het soort bewerkingen dat is toegestaan.

shflag
Het type delen is toegestaan.

pmode
Machtigingsinstelling.

Retourwaarde

Elk van deze functies retourneert een bestandsdescriptor voor het geopende bestand.

Als filename of oflag een NULL aanwijzer is, of als oflag deze shflag niet binnen een geldig bereik met waarden valt, wordt de ongeldige parameterhandler aangeroepen, zoals beschreven in parametervalidatie. Als de uitvoering mag worden voortgezet, retourneren deze functies -1 en worden ingesteld errno op een van de volgende waarden.

Zie , , _doserrnoen _sys_errlist_sys_nerrvoor meer informatie over deze en andere retourcodeserrno .

Opmerkingen

De _sopen functie opent het bestand dat is opgegeven door filename en bereidt het bestand voor op gedeeld lezen of schrijven, zoals gedefinieerd door oflag en shflag. _wsopen is een breedtekenversie van _sopen; het argument dat u filename wilt _wsopen gebruiken is een tekenreeks met een breed teken. _wsopen en _sopen gedraagt zich op dezelfde manier als anders.

De globale status van deze functie is standaard gericht op de toepassing. Zie Globale status in de CRT-om deze te wijzigen.

Algemene routinetoewijzingen voor tekst

De expressie oflag voor gehele getallen wordt gevormd door een of meer van de volgende manifestconstanten te combineren, die zijn gedefinieerd in <fcntl.h>. Wanneer twee of meer constanten het argument oflagvormen, worden ze gecombineerd met de operator bitwise-OR ( | ).

Als u de modus voor bestandstoegang wilt opgeven _O_RDONLY, moet u ofwel , _O_RDWRof _O_WRONLY. Er is geen standaardwaarde voor de toegangsmodus.

Wanneer een bestand wordt geopend in de Unicode-modus door invoerfuncties te gebruiken_O_WTEXT_O_U8TEXT, of_O_U16TEXT, vertalen invoerfuncties de gegevens die uit het bestand worden gelezen in UTF-16-gegevens die zijn opgeslagen als typewchar_t. Functies die schrijven naar een bestand dat is geopend in de Unicode-modus, verwachten buffers die UTF-16-gegevens bevatten die zijn opgeslagen als type wchar_t. Als het bestand is gecodeerd als UTF-8, worden UTF-16-gegevens omgezet in UTF-8 wanneer het wordt geschreven. De UTF-8-gecodeerde inhoud van het bestand wordt omgezet in UTF-16 wanneer deze wordt gelezen. Een poging om een oneven aantal bytes in de Unicode-modus te lezen of schrijven, veroorzaakt een parametervalidatiefout. Als u gegevens wilt lezen of schrijven die zijn opgeslagen in uw programma als UTF-8, gebruikt u een tekst- of binaire bestandsmodus in plaats van een Unicode-modus. U bent verantwoordelijk voor elke vereiste coderingsvertaling.

Als _sopen wordt aangeroepen met | _O_APPEND_O_WRONLY(toevoegmodus) en _O_WTEXT, _O_U16TEXTof_O_U8TEXT, wordt eerst geprobeerd het bestand te openen voor lezen en schrijven, de bom te lezen en vervolgens opnieuw te openen voor schrijven. Als het openen van het bestand voor lezen en schrijven mislukt, wordt het bestand alleen geopend voor schrijven en wordt de standaardwaarde gebruikt voor de instelling unicodemodus.

Het argument shflag is een constante expressie die bestaat uit een van de volgende manifestconstanten, die zijn gedefinieerd in <share.h>.

Het pmode argument is alleen vereist wanneer _O_CREAT deze is opgegeven. Als het bestand niet bestaat, pmode geeft u de machtigingsinstellingen van het bestand op, die worden ingesteld wanneer het nieuwe bestand de eerste keer wordt gesloten. pmode Anders wordt dit genegeerd. pmode is een expressie met een geheel getal dat een of beide manifestconstanten _S_IWRITE bevat en _S_IREAD, die zijn gedefinieerd in <sys\stat.h>. Wanneer beide constanten worden gegeven, worden ze gecombineerd met de bitwise-OR-operator. De betekenis is pmode als volgt.

Als er geen schrijfmachtiging is opgegeven, heeft het bestand het kenmerk Alleen-lezen. In het Windows-besturingssysteem zijn alle bestanden leesbaar; Het is niet mogelijk om alleen-schrijvenmachtigingen te verlenen. Daarom zijn de modi _S_IWRITE en _S_IREAD | _S_IWRITE gelijkwaardig.

_sopen past het huidige masker voor bestandsmachtigingen toe op pmode voordat de machtigingen zijn ingesteld. Zie _umask voor meer informatie.

Behoeften

Zie Compatibiliteit voor meer compatibiliteitsinformatie.

Voorbeeld

Zie het voorbeeld voor _locking.

Zie ook

I/O op laag niveau
_close
_creat, _wcreat
fopen, _wfopen
_fsopen, _wfsopen
_open, _wopen