WSLogFileNameForLink (C 函数)

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

在文件系统中,为日志文件计算一个合适的名称和(可选的)地点,以记录由 l 指定的 WSTP 连接中的 WSTP 数据流,并将名称存储在 name 中.

更多信息

  • WSLogFileNameForLink() 通过调用 WSReleaseLogFileNameForLink() 为必须释放的日志文件名称而分配内存. 如果 WSLogFileNameForLink() 失败且返回一个错误,则不要使用 WSReleaseLogFileNameForLink() 来释放 name 的内容.
  • 若函数成功,则 WSLogFileNameForLink() 返回1;若成功,则返回0.
  • WSTP 的标头文件 wstp.h 已对 WSLogFileNameForLink() 作出声明.

范例

基本范例  (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;
}