Função NPAddConnection (npapi.h)

Artigo
08/25/2023

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.

Valor	Significado
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 um 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 RESOURCETYPE _ANY será usado se o chamador não se importar ou não souber.

[in] lpPassword

Ponteiro para a senha a ser usada para fazer a conexão, normalmente a senha associada a 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, limpe-a da memória chamando a função SecureZeroMemory . Para obter mais informações sobre como proteger a senha, consulte Manipulando senhas.

[in] lpUserName

Ponteiro para o nome de usuário usado para fazer a conexão. Se FOR 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ê estivesse conectado usando o nome de usuário "MyAccount" e quisesse 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" em lpUserName para se conectar ao recurso. Você também especificaria a senha dessa segunda conta em lpPassword.

Retornar valor

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	Descrição
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 foi negada.
WN_NO_NETWORK	A rede não está presente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	npapi.h