次の方法で共有

NPAddConnection 関数 (npapi.h)

NPAddConnection 関数は、ローカル デバイスをネットワーク リソースに接続します。

構文

DWORD NPAddConnection(
  [in] LPNETRESOURCEW lpNetResource,
  [in] LPWSTR         lpPassword,
  [in] LPWSTR         lpUserName
);

パラメーター

[in] lpNetResource

接続先のネットワーク リソースを指定する NETRESOURCE 構造体へのポインター。 渡す NETRESOURCE 構造体には、次のフィールドを設定する必要があります。 NPAddConnection 関数は、他のフィールドを無視します。

価値 Meaning
lpRemoteName
 接続先のネットワーク リソースを指定します。
lpLocalName
 リダイレクトするローカル デバイスの名前 ("F:" や "LPT1" など) を指定します。 この名前は大文字と小文字が区別されず、空の文字列または NULL ポインターである可能性があります。 文字列が空または NULL の場合、関数はリダイレクトを行わずにネットワーク リソースに接続します。
dwType
 接続するリソースの種類を指定します。 RESOURCETYPE_DISK、RESOURCETYPE _PRINT、またはRESOURCETYPE_ANYを指定できます。 RESOURCETYPE _ANY値は、呼び出し元が気にしない場合、または認識していない場合に使用されます。

[in] lpPassword

接続の作成に使用するパスワード (通常は lpUserName に関連付けられているパスワード) へのポインター。 NULL 値を渡して、関数が既定のパスワードを使用するようにすることができます。 パスワードを指定しない場合は、空の文字列を使用できます。 パスワードの使用が完了したら、 SecureZeroMemory 関数を呼び出してメモリからクリアします。 パスワードの保護の詳細については、「パスワードの 処理」を参照してください。

[in] lpUserName

接続を確立するために使用するユーザー名へのポインター。 NULL の場合、既定のユーザー名 (現在ログオンしているユーザーの名前) が適用されます。 これは、ユーザーがリソースに接続したいが、そのリソースに対して割り当てられたユーザー名またはアカウントが異なる場合に使用されます。

たとえば、ユーザー名 "MyAccount" を使用してログに記録し、ユーザー名が "MyOtherAccount" である 2 つ目のアカウントでのみ使用できるネットワーク リソースに接続する場合は、リソースに接続するために lpUserName に "MyOtherAccount" を指定できます。 また、 lpPassword でこの 2 番目のアカウントのパスワードを指定します。

戻り値

関数が成功すると、WN_SUCCESSが返されます。 それ以外の場合は、次のいずれかのエラー コードを返す必要があります。

リターン コード Description
WN_BAD_NETNAME
 lpNetResource に渡される構造体の lpRemoteName メンバーの値は、このプロバイダーでは無効です。
WN_BAD_LOCALNAME
 lpNetResource に渡される構造体の lpLocalName メンバーの値が無効です。
WN_BAD_PASSWORD
 指定されたパスワードが無効です。
WN_ALREADY_CONNECTED
 lpNetResource に渡される構造体の lpLocalName メンバーで指定されたデバイスは既に接続されています。
WN_ACCESS_DENIED
 接続を確立するためのアクセス許可が拒否されました。
WN_NO_NETWORK
 ネットワークが存在しません。

Requirements

Requirement 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
Header npapi.h
Library davclnt.lib
  • Last updated on