共通デスクトップ環境 ToolTalk メッセージの概要

tt_host_file_netfile

char *  tt_host_file_netfile(   const char *    host,		
                                const char *    filename );

tt_host_file_netfile() 関数は、リモート・ホスト上のローカル・パス名と正規のパス名とを対応づけます。host で指定したファイルを、ネットワーク上の他のホストに渡すことができる netfilename に変換します。filename は、リモート・ホストで有効な絶対パス名または相対パス名です。filename の最後のコンポーネントは必須ではありませんが、その他の各コンポーネントは必ず存在しなければなりません。


注 -

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


この関数は、エラー・ポインタを返すか、正常終了した場合は未指定の書式の新たに割り当てられた NULL で終了する文字列を返します。この文字列は tt_netfile_file 関数に渡されます。

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

表 C-2 tt_host_file_netfile が返す可能性のあるエラー

エラー 

説明 

TT_ERR_PATH

filename はリモート・ホスト上では有効でないパスです。

TT_ERR_DBAVAIL

ホスト上の rpc.ttdbserverd に到達できませんでした。

TT_ERR_DBEXIST

rpc.ttdbserverd はホストに適切にインストールされていない可能性があります。

TT_ERR_UNIMP

rpc.ttdbserverd バージョンは、tt_host_file_netfile() 関数をサポートしていません。

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