Compartilhar via

Função NPAddConnection (npapi.h)

A função NPAddConnection conecta um dispositivo local a um recurso de rede.

Sintaxe

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

Parâmetros

[in] lpNetResource

Ponteiro para uma estrutura NETRESOURCE que especifica o recurso de rede ao qual se conectar. Os campos a seguir devem ser definidos na estrutura NETRESOURCE que você passa. A função NPAddConnection ignora os outros campos.

Value Meaning
lpRemoteName
 Especifica o recurso de rede ao qual se conectar.
lpLocalName
 Especifica o nome de um dispositivo local a ser redirecionado, como "F:" ou "LPT1". Esse nome é tratado como não diferencia maiúsculas de minúsculas e pode ser uma cadeia de caracteres vazia ou ponteiro NULL . Se a cadeia de caracteres estiver vazia ou NULL, a função se conectará ao recurso de rede sem fazer um redirecionamento.
dwType
 Especifica o tipo de recurso ao qual se conectar. Isso pode ser RESOURCETYPE_DISK, _PRINT RESOURCETYPE ou RESOURCETYPE_ANY. O valor _ANY RESOURCETYPE será usado se o chamador não se importar ou não souber.

[in] lpPassword

Ponteiro para a senha a ser usada na criação da conexão, normalmente a senha associada ao lpUserName. O valor NULL pode ser passado para fazer com que a função use a senha padrão. Uma cadeia de caracteres vazia pode ser usada para indicar nenhuma senha. Quando terminar de usar a senha, desmarque-a da memória chamando a função SecureZeroMemory . Para obter mais informações sobre como proteger a senha, consulte Como lidar com senhas.

[in] lpUserName

Ponteiro para o nome de usuário usado para fazer a conexão. Se NULL, o nome de usuário padrão (o do usuário conectado no momento) será aplicado. Isso é usado quando o usuário deseja se conectar a um recurso, mas tem um nome de usuário ou conta atribuído diferente para esse recurso.

Por exemplo, se você foi conectado usando o nome de usuário "MyAccount" e queria se conectar a um recurso de rede que estava disponível apenas para uma segunda conta, em que o nome de usuário era "MyOtherAccount", você poderia especificar "MyOtherAccount" no lpUserName para se conectar ao recurso. Você também especificaria a senha dessa segunda conta no lpPassword.

Valor de retorno

Se a função for bem-sucedida, ela deverá retornar WN_SUCCESS. Caso contrário, ele deverá retornar um código de erro, que pode ser um dos seguintes.

Código de retorno Description
WN_BAD_NETNAME
 O valor do membro lpRemoteName da estrutura passada para lpNetResource não é válido para esse provedor.
WN_BAD_LOCALNAME
 O valor do membro lpLocalName da estrutura passada para lpNetResource não é válido.
WN_BAD_PASSWORD
 A senha especificada não é válida.
WN_ALREADY_CONNECTED
 O dispositivo especificado no membro lpLocalName da estrutura passada para lpNetResource já está conectado.
WN_ACCESS_DENIED
 A permissão para estabelecer a conexão é negada.
WN_NO_NETWORK
 A rede não está presente.

Requirements

Requirement Value
Cliente mínimo suportado Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header npapi.h
Library davclnt.lib
  • Last updated on