Condividi tramite

Funzione NPAddConnection (npapi.h)

  • Articolo

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