NetUseAdd 関数 (lmuse.h)

[アーティクル]
03/05/2024

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