Função PeerPnrpGetEndpoint (p2p.h)
A função PeerPnrpGetEndpoint recupera um endereço de ponto de extremidade par resolvido durante uma operação assíncrona de resolução de nome de par.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpGetEndpoint(
[in] HRESOLUTION hResolve,
[out] PPEER_PNRP_ENDPOINT_INFO *ppEndpoint
);
Parâmetros
[in] hResolve
O identificador para a operação assíncrona de resolução de nome de par retornada por uma chamada anterior para PeerPnrpStartResolve.
[out] ppEndpoint
Ponteiro para o endereço de uma estrutura PEER_PNRP_ENDPOINT_INFO que contém um endereço de ponto de extremidade para o nome do par fornecido na chamada anterior para PeerPnrpStartResolve.
Esses dados retornados por esse parâmetro devem ser liberados chamando PeerFreeData.
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 |
|---|---|
|
Um dos parâmetros não é válido. |
|
Não há memória suficiente para executar a operação especificada. |
|
Todos os endereços de ponto de extremidade foram recuperados para o par. |
Comentários
PeerPnrpStartResolve cria um identificador para uma operação assíncrona de resolução de nome de par.
Sempre que um ponto de extremidade é encontrado, o identificador de evento fornecido em hEvent é sinalizado e PeerPnrpGetEndpoint deve ser chamado com o identificador phResolve pelo aplicativo para obter esse ponto de extremidade.
O último evento especifica o código de erro PEER_E_NO_MORE, indicando que todos os pontos de extremidade correspondentes ao nome do par fornecido a PeerPnrpStartResolve foram encontrados. Neste momento, o aplicativo deve fechar o identificador com uma chamada para PeerPnrpEndResolve.
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 |