NPAddConnection-Funktion (npapi.h)

Artikel
03/13/2024

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

Syntax

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

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 NETRESOURCE-Struktur festgelegt werden, die Sie übergeben. 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". Bei diesem Namen wird die Groß-/Kleinschreibung nicht beachtet 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 her, ohne eine Umleitung vorzunehmen.
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 sich der Aufrufer nicht darum kümmert oder nicht weiß.

[in] lpPassword

Zeiger 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 Arbeitsspeicher, indem Sie die SecureZeroMemory-Funktion aufrufen. Weitere Informationen zum Schutz des Kennworts finden Sie unter Behandeln von Kennwörtern.

[in] lpUserName

Zeiger auf den Benutzernamen, der zum Herstellen der Verbindung verwendet wird. Bei 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 einen anderen Benutzernamen oder ein anderes Konto für diese Ressource zugewiesen hat.

Wenn Sie beispielsweise mit dem Benutzernamen "MyAccount" protokolliert wurden und eine Verbindung mit einer Netzwerkressource herstellen wollten, die nur für ein zweites Konto verfügbar war, wobei der Benutzername "MyOtherAccount" lautet, können 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 einer der folgenden sein kann.

Rückgabecode	Beschreibung
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-Member der an lpNetResource übergebene Struktur angegebene Gerät 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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	npapi.h