Función NPAddConnection (npapi.h)
La función NPAddConnection conecta un dispositivo local a un recurso de red.
Sintaxis
DWORD NPAddConnection(
[in] LPNETRESOURCEW lpNetResource,
[in] LPWSTR lpPassword,
[in] LPWSTR lpUserName
);
Parámetros
[in] lpNetResource
Puntero a una estructura NETRESOURCE a la que se especifica el recurso de red al que se va a conectar. Los campos siguientes deben establecerse en la estructura NETRESOURCE que se pasa. La función NPAddConnection omite los demás campos.
[in] lpPassword
Puntero a la contraseña que se va a usar para establecer la conexión, normalmente la contraseña asociada a lpUserName. El valor NULL se puede pasar para hacer que la función use la contraseña predeterminada. Se puede usar una cadena vacía para indicar que no hay contraseña. Cuando haya terminado de usar la contraseña, desactive la memoria llamando a la función SecureZeroMemory . Para obtener más información sobre cómo proteger la contraseña, consulte Control de contraseñas.
[in] lpUserName
Puntero al nombre de usuario usado para establecer la conexión. Si es NULL, se aplica el nombre de usuario predeterminado (el del usuario que ha iniciado sesión actualmente). Esto se usa cuando el usuario quiere conectarse a un recurso, pero tiene un nombre de usuario o una cuenta asignados diferentes para ese recurso.
Por ejemplo, si ha iniciado sesión con el nombre de usuario "MyAccount" y quería conectarse a un recurso de red que solo estaba disponible para una segunda cuenta, donde el nombre de usuario era "MyOtherAccount", podría especificar "MyOtherAccount" en lpUserName para conectarse al recurso. También especificaría la contraseña de esta segunda cuenta en lpPassword.
Valor devuelto
Si la función se ejecuta correctamente, debe devolver WN_SUCCESS. De lo contrario, debe devolver un código de error, que puede ser uno de los siguientes.
Código devuelto | Descripción |
---|---|
|
El valor del miembro lpRemoteName de la estructura pasada a lpNetResource no es válido para este proveedor. |
|
El valor del miembro lpLocalName de la estructura pasada a lpNetResource no es válido. |
|
La contraseña especificada no es válida. |
|
El dispositivo especificado en el miembro lpLocalName de la estructura pasada a lpNetResource ya está conectado. |
|
Se deniega el permiso para establecer la conexión. |
|
La red no está presente. |
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | npapi.h |