NPAddConnection 関数 (npapi.h)

  • [アーティクル]

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

構文

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

パラメーター

[in] lpNetResource

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

値 意味
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を返す必要があります。 それ以外の場合は、次のいずれかのエラー コードを返す必要があります。

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー npapi.h