tmpfile_s

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

一時ファイルを作成します。この関数は、「CRT のセキュリティ強化」に説明されているように、tmpfile のセキュリティが強化されたバージョンです。

errno_t tmpfile(
   FILE** pFilePtr
);

パラメータ

[出力] pFilePtr
ストリームへの生成ポインタのアドレスを格納するポインタのアドレス。

戻り値

正常終了した場合は 0 を返します。失敗した場合はエラーコードを返します。

エラー条件

pFilePtr	戻り値	内容:pFilePtr
NULL	EINVAL	変更されない

上記のパラメータ検証エラーが発生すると、「パラメータの検証」に説明されているように、無効なパラメータハンドラが呼び出されます。実行の継続が許可された場合、errno が EINVAL に設定され、戻り値はEINVAL となります。

解説

tmpfile 関数は一時ファイルを作成し、そのストリームへのポインタを pFilePtr 引数に格納します。一時ファイルは、ルートディレクトリに作成されます。ルート以外のディレクトリに一時ファイルを作成するには、tmpnam または tempnam を fopen と共に使用します。

ファイルを開けない場合、tmpfile_s 関数は NULL を pFilePtr パラメータに書き込みます。この一時ファイルは、ファイルが閉じられたとき、プログラムが正常に終了したとき、または _rmtmp が呼び出されたときに、自動的に削除されます。これは、現在の作業ディレクトリが変更されていないことを前提とします。一時ファイルは w+b (バイナリ読み書き両用) モードで開かれます。

tmpfile_s. で TMP_MAX_S (STDIO.H を参照) よりも多く呼び出しを試行した場合は、エラーが発生することがあります。

必要条件

ルーチン	必須ヘッダー
tmpfile_s	<stdio.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

メモ :
この例を Windows Vista で実行するには管理者特権が必要です。

// crt_tmpfile_s.c
// This program uses tmpfile to create a
// temporary file, then deletes this file with _rmtmp.
//

#include <stdio.h>

int main( void )
{
   FILE *stream;
   char tempstring[] = "String to be written";
   int  i;
   errno_t err;

   // Create temporary files.
   for( i = 1; i <= 3; i++ )
   {
      err = tmpfile_s(&stream);
      if( err )
         perror( "Could not open new temporary file\n" );
      else
         printf( "Temporary file %d was created\n", i );
   }

   // Remove temporary files.
   printf( "%d temporary files deleted\n", _rmtmp() );
}

Temporary file 1 was created
Temporary file 2 was created
Temporary file 3 was created
3 temporary files deleted