NetUseAdd 関数 (lmuse.h)

NetUseAdd 関数は、ローカル コンピューターとリモート サーバー間の接続を確立します。 接続するローカル ドライブ文字またはプリンター デバイスを指定できます。 ローカル ドライブ文字またはプリンター デバイスを指定しない場合、関数は今後の接続のためにサーバーでクライアントを認証します。

構文

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

パラメーター

[in] servername

この関数を実行するコンピューターの UNC 名。 このパラメーターが NULL の場合は、ローカル コンピューターが使用されます。 指定された UncServerName パラメーターがリモート コンピューターの場合、リモート コンピューターは従来のリモート アクセス プロトコル メカニズムを使用してリモート RPC 呼び出しをサポートする必要があります。

_WIN32_WINNTまたはFORCE_UNICODEが定義されている場合、この文字列は Unicode です。

[in] LevelFlags

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

[in] buf

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

[out] parm_err

ERROR_INVALID_PARAMETER エラーが返されたときにエラーが発生した情報構造体の最初のメンバーのインデックスを受け取る値へのポインター。 このパラメーターが NULL の場合、エラー時にインデックスは返されません。 詳細については、「解説」を参照してください。

戻り値

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

関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの一覧については、「 システム エラー コード」を参照してください。

注釈

WNetAddConnection2 および WNetAddConnection3 関数を使用して、ローカル デバイスをネットワーク リソースにリダイレクトすることもできます。

NetUseAdd 関数を呼び出すために、特別なグループ メンバーシップは必要ありません。 ダウンレベル互換性がある場合を除き、リモート サーバーでこの関数を実行することはできません。

この関数は、サーバー メッセージ ブロック (LAN マネージャー ワークステーション) クライアントにのみ適用されます。 NetUseAdd 関数は、分散ファイル システム (DFS) 共有をサポートしていません。 別のネットワーク プロバイダー (WebDAV または DFS 共有など) を使用して共有を追加するには、 WNetAddConnection2 または WNetAddConnection3 関数を使用します。

NetUseAdd 関数がERROR_INVALID_PARAMETERを返す場合は、ParmError パラメーターを使用して、無効な情報構造体の最初のメンバーを示すことができます。 (情報構造は USE_INFO_ で始まり、その形式は Level パラメーターで指定されます)。次の表に、 ParmError パラメーターで返すことができる値と、エラーが発生している対応する構造体メンバーを示します。 (プレフィックス ui*_ は、メンバーが複数のプレフィックス (ui1_やui2_など) で始めることができることを示します。

要件

こちらもご覧ください

NetUseDel

ネットワーク管理機能

ネットワーク管理の概要

USE_INFO_1

USE_INFO_2

関数を使用する

WNetAddConnection2

WNetAddConnection3