Función NPAddConnection (npapi.h)

Artículo
03/05/2024

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.

Valor	Significado
lpRemoteName	Especifica el recurso de red al que se va a conectar.
lpLocalName	Especifica el nombre de un dispositivo local que se va a redirigir, como "F:" o "LPT1". Este nombre se trata como sin distinción entre mayúsculas y minúsculas y puede ser una cadena vacía o un puntero NULL . Si la cadena está vacía o NULL, la función se conecta al recurso de red sin realizar un redireccionamiento.
dwType	Especifica el tipo de recurso al que se va a conectar. Esto puede ser RESOURCETYPE_DISK, _PRINT RESOURCETYPE o RESOURCETYPE_ANY. El valor RESOURCETYPE _ANY se usa si el autor de la llamada no le importa o no sabe.

[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
WN_BAD_NETNAME	El valor del miembro lpRemoteName de la estructura pasada a lpNetResource no es válido para este proveedor.
WN_BAD_LOCALNAME	El valor del miembro lpLocalName de la estructura pasada a lpNetResource no es válido.
WN_BAD_PASSWORD	La contraseña especificada no es válida.
WN_ALREADY_CONNECTED	El dispositivo especificado en el miembro lpLocalName de la estructura pasada a lpNetResource ya está conectado.
WN_ACCESS_DENIED	Se deniega el permiso para establecer la conexión.
WN_NO_NETWORK	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