_lcreat 関数 (winbase.h)

[この関数は、16 ビットバージョンの Windows との互換性のために提供されます。新しいアプリケーションでは、 CreateFile 関数を使用する必要があります。]

指定したファイルを作成または開きます。このドキュメントは、既存のコードのトラブルシューティングにのみ含まれています。

構文

HFILE _lcreat(
  LPCSTR lpPathName,
  int    iAttribute
);

lpPathName

ファイルの名前です。文字列は、Windows ANSI 文字セットの文字で構成されている必要があります。

iAttribute

ファイルの属性。

このパラメーターは、次のいずれかの値に設定する必要があります。

値	意味
0	標準。制限なく、読み取りまたは書き込みが可能です。
1	読み取り専用です。書き込みのために開くことができません。
2	非表示。ディレクトリ検索で見つかりません。
4	System. ディレクトリ検索で見つかりません。

関数が成功した場合、戻り値はファイルハンドルです。それ以外の場合、戻り値はHFILE_ERROR。拡張エラー情報を取得するには、 GetLastError 関数を使用します。

ファイルが存在しない場合は、 _lcreat が作成され、書き込み用の新しいファイルが開きます。ファイルが存在する場合は、 _lcreat ファイルサイズを 0 に切り捨てて、読み取りと書き込みのために開きます。

関数がファイルを開くと、ポインターはファイルの先頭に設定されます。

_lcreat関数は注意して使用してください。別の関数によって既に開かれているファイルであっても、任意のファイルを開くことができます。