NPAddConnection 関数 (npapi.h)
NPAddConnection 関数は、ローカル デバイスをネットワーク リソースに接続します。
構文
DWORD NPAddConnection(
[in] LPNETRESOURCEW lpNetResource,
[in] LPWSTR lpPassword,
[in] LPWSTR lpUserName
);
パラメーター
[in] lpNetResource
接続するネットワーク リソースを指定する NETRESOURCE 構造体へのポインター。 渡す NETRESOURCE 構造体では、次のフィールドを設定する必要があります。 NPAddConnection 関数は、他のフィールドを無視します。
[in] lpPassword
接続に使用するパスワードへのポインター。通常は lpUserName に関連付けられているパスワード。 NULL 値を渡して、関数が既定のパスワードを使用するようにすることができます。 パスワードを指定しない場合は、空の文字列を使用できます。 パスワードの使用が完了したら、 SecureZeroMemory 関数を呼び出してメモリからクリアします。 パスワードの保護の詳細については、「パスワードの 処理」を参照してください。
[in] lpUserName
接続に使用するユーザー名へのポインター。 NULL の場合、既定のユーザー名 (現在ログオンしているユーザーの名前) が適用されます。 これは、ユーザーがリソースに接続したいが、そのリソースに割り当てられたユーザー名またはアカウントが異なる場合に使用されます。
たとえば、ユーザー名 "MyAccount" を使用してログに記録し、ユーザー名が "MyOtherAccount" である 2 つ目のアカウントでのみ使用できるネットワーク リソースに接続する場合は、リソースに接続するために lpUserName に "MyOtherAccount" を指定できます。 lpPassword では、この 2 番目のアカウントのパスワードも指定します。
戻り値
関数が成功した場合は、WN_SUCCESSを返す必要があります。 それ以外の場合は、次のいずれかのエラー コードを返す必要があります。
リターン コード | 説明 |
---|---|
|
lpNetResource に渡される構造体の lpRemoteName メンバーの値は、このプロバイダーでは無効です。 |
|
lpNetResource に渡される構造体の lpLocalName メンバーの値が無効です。 |
|
指定されたパスワードが無効です。 |
|
lpNetResource に渡される構造体の lpLocalName メンバーで指定されたデバイスは既に接続されています。 |
|
接続を確立するためのアクセス許可が拒否されました。 |
|
ネットワークが存在しません。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | npapi.h |