tt_host_netfile_file

char * tt_host_netfile_file(  const char *      host,
                              const char *      netfilename );

tt_host_file_netfile() 関数は、リモート・ホスト上のローカル・パス名と正規のパス名とを対応づけます。netfilename で指定したファイルを、リモート・ホスト上で有効なパス名に変換します。netfilename は、tt_netfile_file 関数によって返される NULL で終了する文字列のコピーです。

この関数を使用する前に tt_open 関数を呼び出す必要はありません。

指定されたファイルが現在ローカル・ホストにマウントされていない場合、次のような書式のパス名が作成されます。

/DTMOUNTPOINT/host/filepath

DTMOUNTPOINT は、オートマウントのホスト・マップのために作成されたマウント・ポイントです。環境変数 DTMOUNTPOINT で、このマウント・ポイントを指定することもできます。

host は、ファイルを格納しているホストです。

filepath は、ホストに格納されているファイルに対するパスです。

この関数は、エラー・ポインタを返すか、正常終了した場合は新たに割り当てられた NULL で終了するローカル・ファイル名を返します。

エラー・ポインタからステータスを取り出すには、tt_ptr_error を使用します。返される可能性のあるエラーを表 C-3 に示します。

割り当てられた文字列を解除するには、tt_free または tt_release 呼び出しを使用します。

ファイル名を同じファイルのローカル・ファイル名に戻すには、tt_host_file_netfile() 関数を使用します。