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

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

値 説明
0
 ワークステーション のトランスポート プロトコル情報を指定します。 buf パラメーターは、WKSTA_TRANSPORT_INFO_0構造体を指します。

[in] buf

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

[out] parm_err

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

戻り値

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

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

リターン コード 説明
ERROR_ACCESS_DENIED
 ユーザーには、要求された情報へのアクセス権がありません。
ERROR_INVALID_LEVEL
 level パラメーターは、使用できるデータ構造情報のレベルを示しますが、無効です。
ERROR_INVALID_PARAMETER
 関数パラメーターの 1 つが無効です。

解説

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

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

値 メンバー
TRANSPORT_QUALITYOFSERVICE_PARMNUM wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM wkti0_transport_name

必要条件

   
対象プラットフォーム Windows
ヘッダー lmwksta.h (include Lm.h, Lmwksta.h)
Library Netapi32.lib
[DLL] Netapi32.dll