WSLogFileNameForLink （C 関数）

int WSLogFileNameForLink( WSLINK l , const char ** name )

ログファイルに対して，適切な名前と（ときには）ファイルシステム内の場所を計算して，l で指定されたWSTP接続内のWSTPデータストリームへのログを送信し，名前を name 内に保存する．

詳細

  • WSLogFileNameForLink()は，WSReleaseLogFileNameForLink()を呼び出して解放しなければならないログファイルの名前にメモリを割り当てる．WSLogFileNameForLink()が失敗しエラーを返す場合には，name の内容を解放するのにWSReleaseLogFileNameForLink()を使ってはならない．
  • WSLogFileNameForLink()は，成功した場合には1を，失敗した場合には0を返す．
  • WSLogFileNameForLink()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

int main(int argc, char **argv)
{
    WSENV env;
    WSLINK link;
    int error;
    const char *logFileName;
    int apiResult;

    env = WSInitialize((WSEnvironmentParameter)0);
    if(env == (WSENV)0)
    { /* Unable to create WSTP environment object */ }

    link = WSOpenArgcArgv(env, argc, argv, &error);
    if(link == (WSLINK)0 || error != WSEOK)
    { /* Unable to create link object */ }

    WSActivate(link);

    /* ... */

    apiResult = WSLogFileNameForLink(link, &logFileName);
    if(! apiResult =)
    { /* Unable to generate a file name */ }

    apiResult = WSLogStreamToFile(link, logFileName);
    { /* unable to log to logFileName */ }

    WSReleaseLogFileNameForLink(link, logFileName);

    /* ... */

    WSClose(link);
    WSDeinitialize(env);

    return 0;
}