Compartilhar via

Função PeerPnrpRegister (p2p.h)

A função PeerPnrpRegister registra um par com uma nuvem PNRP e retorna um identificador que pode ser usado para atualizações de registro.

Nota Quando chamada, essa função será bloqueada até que o serviço PNRP seja iniciado.
 

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpRegister(
  [in]           PCWSTR                       pcwzPeerName,
  [in, optional] PPEER_PNRP_REGISTRATION_INFO pRegistrationInfo,
  [out]          HREGISTRATION                *phRegistration
);

Parâmetros

[in] pcwzPeerName

Ponteiro para uma cadeia de caracteres Unicode terminada em zero que contém o nome do par a ser registrado no serviço PNRP.

[in, optional] pRegistrationInfo

Ponteiro para uma estrutura de PEER_PNRP_REGISTRATION_INFO que contém as informações do ponto de extremidade para o nó par de registro. Se FOR NULL, a API registrará o par com todas as nuvens PNRP conhecidas e todos os endereços registrados serão selecionados automaticamente pela infraestrutura.

[out] phRegistration

Manipule para o registro PNRP para o nó par de chamada. Use esse identificador para atualizar o registro ou para cancelar o registro com o serviço PNRP.

Retornar valor

Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará um dos valores a seguir.

Código de retorno Descrição
E_INVALIDARG
 Um dos parâmetros não é válido.
E_OUTOFMEMORY
 Não há memória suficiente para executar a operação especificada.
PEER_E_IDENTITY_NOT_FOUND
 O par local está usando uma identidade que não existe.
 

Além disso, essa função pode retornar valores WSA. Para obter uma lista completa dos valores possíveis, consulte Códigos de erro NSP PNRP.

Comentários

Um identificador deve ser registrado em um processo separado do processo em que ele será resolvido. Se um identificador for registrado e resolvido dentro do mesmo processo, ele não será reconhecido.

Um nome não pode ser registrado com um ponto de extremidade mais de uma vez. Quando forem necessárias atualizações para um nome registrado, use PeerPnrpUpdateRegistration.

Quando pRegistrationInfo for NULL ou PEER_PNRP_AUTO_ADDRESSES for especificado para cAddresses, a infraestrutura manterá os endereços registrados atualizados à medida que os endereços forem alterados ou as alterações de disponibilidade na nuvem.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado para Windows XP
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho p2p.h
Biblioteca P2P.lib
DLL P2P.dll

Confira também

PeerPnrpUnregister

PeerPnrpUpdateRegistration

  • Last updated on