Compartilhar via


Método INetConnection::D uplicate (netcon.h)

[O Firewall de Conexão com a Internet pode estar alterado ou indisponível em versões subsequentes. Em vez disso, use a API de Firewall do Windows.]

O método Duplicate cria uma duplicata dessa conexão na pasta de conexões.

Sintaxe

HRESULT Duplicate(
  [in]  LPCWSTR        pszwDuplicateName,
  [out] INetConnection **ppCon
);

Parâmetros

[in] pszwDuplicateName

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome da nova conexão.

[out] ppCon

Ponteiro para um ponteiro de interface que, no retorno bem-sucedido, aponta para uma interface INetConnection para a nova conexão.

Retornar valor

Se o método for bem-sucedido, o valor retornado será S_OK.

Se o método falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno Descrição
E_ABORT
A operação foi anulada.
E_FAIL
Ocorreu um erro não especificado.
E_INVALIDARG
Um dos parâmetros é inválido.
E_NOINTERFACE
Não há suporte para uma interface especificada.
E_NOTIMPL
Um método especificado não é implementado.
E_OUTOFMEMORY
O método não pôde alocar a memória necessária.
E_POINTER
Um ponteiro passado como um parâmetro não é válido.
E_UNEXPECTED
O método falhou por motivos desconhecidos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho netcon.h
DLL Hnetcfg.dll

Confira também

INetConnection

Interfaces de Firewall de Conexão com a Internet e Compartilhamento de Conexão com a Internet

Referência de Firewall de Conexão com a Internet e Compartilhamento de Conexão com a Internet