Funzione NPAddConnection (npapi.h)

Articolo
03/05/2024

La funzione NPAddConnection connette un dispositivo locale a una risorsa di rete.

Sintassi

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

Parametri

[in] lpNetResource

Puntatore a una struttura NETRESOURCE che specifica la risorsa di rete a cui connettersi. I campi seguenti devono essere impostati nella struttura NETRESOURCE passata. La funzione NPAddConnection ignora gli altri campi.

Valore	Significato
lpRemoteName	Specifica la risorsa di rete a cui connettersi.
lpLocalName	Specifica il nome di un dispositivo locale da reindirizzare, ad esempio "F:" o "LPT1". Questo nome viene considerato senza distinzione tra maiuscole e minuscole e può essere una stringa vuota o un puntatore NULL . Se la stringa è vuota o NULL, la funzione si connette alla risorsa di rete senza effettuare un reindirizzamento.
dwType	Specifica il tipo di risorsa a cui connettersi. Può essere RESOURCETYPE_DISK, resourcetype _PRINT o RESOURCETYPE_ANY. Il valore RESOURCETYPE _ANY viene usato se il chiamante non è importante o non conosce.

[in] lpPassword

Puntatore alla password da usare per effettuare la connessione, normalmente la password associata a lpUserName. Il valore NULL può essere passato per causare che la funzione usi la password predefinita. Una stringa vuota può essere usata per indicare nessuna password. Al termine dell'uso della password, cancellarla dalla memoria chiamando la funzione SecureZeroMemory . Per altre informazioni sulla protezione della password, vedere Gestione delle password.

[in] lpUserName

Puntatore al nome utente usato per rendere la connessione. Se NULL, viene applicato il nome utente predefinito (quello dell'utente attualmente connesso). Viene usato quando l'utente vuole connettersi a una risorsa ma ha un nome utente o un account assegnato diverso per tale risorsa.

Ad esempio, se si è registrati usando il nome utente "MyAccount" e si vuole connettersi a una risorsa di rete disponibile solo a un secondo account, dove il nome utente era "MyOtherAccount", è possibile specificare "MyOtherAccount" in lpUserName per connettersi alla risorsa. Specificare anche la password di questo secondo account in lpPassword.

Valore restituito

Se la funzione ha esito positivo, deve restituire WN_SUCCESS. In caso contrario, deve restituire un codice di errore, che può essere uno dei seguenti.

Codice restituito	Descrizione
WN_BAD_NETNAME	Il valore del membro lpRemoteName della struttura passata in lpNetResource non è valido per questo provider.
WN_BAD_LOCALNAME	Il valore del membro lpLocalName della struttura passata in lpNetResource non è valido.
WN_BAD_PASSWORD	La password specificata non è valida.
WN_ALREADY_CONNECTED	Il dispositivo specificato nel membro lpLocalName della struttura passata a lpNetResource è già connesso.
WN_ACCESS_DENIED	L'autorizzazione per stabilire la connessione viene negata.
WN_NO_NETWORK	La rete non è presente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	npapi.h