NetWkstaTransportAdd 関数 (lmwksta.h)

[この関数は廃止されました。 トランスポート プロトコルの既定の設定を手動で変更するには、[ネットワークとダイヤルアップ接続] フォルダーの [ローカル エリア接続のプロパティ] ダイアログ ボックスを使用します。

サポートされていません。

NetWkstaTransportAdd 関数は、リダイレクターをトランスポートにバインド (または接続) します。 リダイレクターは、サーバー コンピューターへのファイル要求を生成するクライアント コンピューター上のソフトウェアです。

構文

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

パラメーター

[in] servername

関数を実行するリモート サーバーの DNS または NetBIOS 名を指定する文字列へのポインター。 このパラメーターが NULL の場合は、ローカル コンピューターが使用されます。

この文字列は、 \で始まる必要があります。

[in] level

データの情報レベルを指定します。 このパラメーターには、次の値を指定できます。

[in] buf

データを指定するバッファーへのポインター。 このデータの形式は、 level パラメーターの値によって異なります。 詳細については、「 ネットワーク管理関数バッファー」を参照してください。

[out] parm_err

ERROR_INVALID_PARAMETER エラーの原因となる最初のパラメーターのインデックスを受け取る値へのポインター。 このパラメーターが NULL の場合、エラー時にインデックスは返されません。

戻り値

関数が成功した場合、戻り値はNERR_Success。

関数が失敗した場合、戻り値には次のいずれかのエラー コードを指定できます。

解説

Administrators ローカル グループのメンバーのみが NetWkstaTransportAdd 関数を正常に実行できます。

NetWkstaTransportAdd 関数がERROR_INVALID_PARAMETERを返す場合は、parm_err パラメーターを使用して、無効なWKSTA_TRANSPORT_INFO_0構造体のメンバーを示すことができます。 次の表に、 parm_err パラメーターで返すことができる値と、エラーが発生している対応する構造体メンバーを示します。

必要条件