Freigeben über

NPAddConnection-Funktion (npapi.h)

Die NPAddConnection-Funktion verbindet ein lokales Gerät mit einer Netzwerkressource.

Syntax

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

Die Parameter

[in] lpNetResource

Zeiger auf eine NETRESOURCE-Struktur , die die Netzwerkressource angibt, mit der eine Verbindung hergestellt werden soll. Die folgenden Felder müssen in der von Ihnen übergebenen NETRESOURCE-Struktur festgelegt werden. Die NPAddConnection-Funktion ignoriert die anderen Felder.

Wert Bedeutung
lpRemoteName
 Gibt die Netzwerkressource an, mit der eine Verbindung hergestellt werden soll.
lpLocalName
 Gibt den Namen eines lokalen Geräts an, das umgeleitet werden soll, z. B. "F:" oder "LPT1". Dieser Name wird als Nicht-Groß-/Kleinschreibung behandelt und kann eine leere Zeichenfolge oder ein NULL-Zeiger sein. Wenn die Zeichenfolge leer oder NULL ist, stellt die Funktion eine Verbindung mit der Netzwerkressource ohne Umleitung hergestellt.
dwType
 Gibt den Typ der Ressource an, mit der eine Verbindung hergestellt werden soll. Dies kann RESOURCETYPE_DISK, RESOURCETYPE-_PRINT oder RESOURCETYPE_ANY sein. Der Wert RESOURCETYPE _ANY wird verwendet, wenn der Aufrufer keine Sorge hat oder nicht weiß.

[in] lpPassword

Zeigen Sie auf das Kennwort, das beim Herstellen der Verbindung verwendet werden soll, normalerweise das Kennwort, das lpUserName zugeordnet ist. Der NULL-Wert kann übergeben werden, damit die Funktion das Standardkennwort verwendet. Eine leere Zeichenfolge kann verwendet werden, um kein Kennwort anzugeben. Wenn Sie das Kennwort verwendet haben, löschen Sie es aus dem Speicher, indem Sie die SecureZeroMemory-Funktion aufrufen. Weitere Informationen zum Schützen des Kennworts finden Sie unter "Behandeln von Kennwörtern".

[in] lpUserName

Zeigen Sie auf den Benutzernamen, der zum Herstellen der Verbindung verwendet wird. Wenn NULL, wird der Standardbenutzername (der des aktuell angemeldeten Benutzers) angewendet. Dies wird verwendet, wenn der Benutzer eine Verbindung mit einer Ressource herstellen möchte, aber über einen anderen zugewiesenen Benutzernamen oder ein anderes Konto für diese Ressource verfügt.

Wenn Sie beispielsweise mit dem Benutzernamen "MyAccount" protokolliert und eine Verbindung mit einer Netzwerkressource herstellen wollten, die nur für ein zweites Konto verfügbar war, bei dem der Benutzername "MyOtherAccount" lautete, könnten Sie "MyOtherAccount" in lpUserName angeben, um eine Verbindung mit der Ressource herzustellen. Sie würden auch das Kennwort dieses zweiten Kontos in lpPassword angeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, sollte sie WN_SUCCESS zurückgeben. Andernfalls sollte ein Fehlercode zurückgegeben werden, der eine der folgenden Sein kann.

Rückgabecode Description
WN_BAD_NETNAME
 Der Wert des lpRemoteName-Members der an lpNetResource übergebenen Struktur ist für diesen Anbieter ungültig.
WN_BAD_LOCALNAME
 Der Wert des lpLocalName-Members der an lpNetResource übergebenen Struktur ist ungültig.
WN_BAD_PASSWORD
 Das angegebene Kennwort ist ungültig.
WN_ALREADY_CONNECTED
 Das im lpLocalName-Element der an lpNetResource übergebene Struktur ist bereits verbunden.
WN_ACCESS_DENIED
 Die Berechtigung zum Herstellen der Verbindung wird verweigert.
WN_NO_NETWORK
 Das Netzwerk ist nicht vorhanden.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Zielplattform Fenster
Header npapi.h
Library davclnt.lib
  • Last updated on