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

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

値 意味
1
 ローカル デバイスと共有リソースの間の接続に関する情報を指定します。 情報には、接続の状態と種類が含まれます。 Buf パラメーターは、USE_INFO_1構造体へのポインターです。
2
 ローカル デバイスと共有リソースの間の接続に関する情報を指定します。 情報には、接続の状態と種類、ユーザー名とドメイン名が含まれます。 Buf パラメーターは、USE_INFO_2構造体へのポインターです。

[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_など) で始めることができることを示します。

定数 値 メンバー
USE_LOCAL_PARMNUM 1 ui*_local
USE_REMOTE_PARMNUM 2 ui*_remote
USE_PASSWORD_PARMNUM 3 ui*_password
USE_ASGTYPE_PARMNUM 4 ui*_asg_type
USE_USERNAME_PARMNUM 5 ui*_username
USE_DOMAINNAME_PARMNUM 6 ui*_domainname

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー lmuse.h (Include Lm.h)
Library Netapi32.lib
[DLL] Netapi32.dll

こちらもご覧ください

NetUseDel

ネットワーク管理機能

ネットワーク管理の概要

USE_INFO_1

USE_INFO_2

関数を使用する

WNetAddConnection2

WNetAddConnection3