Compartir a través de

Función NPAddConnection (npapi.h)

La función NPAddConnection conecta un dispositivo local a un recurso de red.

Syntax

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 conectarse. Los siguientes campos deben establecerse en la estructura NETRESOURCE que se pasa. La función NPAddConnection omite los demás campos.

Importancia Meaning
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 no distingue mayúsculas de 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 una redirección.
dwType
 Especifica el tipo de recurso al que conectarse. 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 lo sabe.

[in] lpPassword

Puntero a la contraseña que se va a usar para realizar 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 realizar 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 de retorno Description
WN_BAD_NETNAME
 El valor del miembro lpRemoteName de la estructura que se pasa a lpNetResource no es válido para este proveedor.
WN_BAD_LOCALNAME
 El valor del miembro lpLocalName de la estructura que se pasa 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 que se pasa 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

Requirement Importancia
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
Header npapi.h
Library davclnt.lib
  • Last updated on