Função PeerCollabQueryContactData (p2p.h)

A função PeerCollabQueryContactData recupera as informações de contato para o ponto de extremidade par fornecido.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabQueryContactData(
  [in, optional] PCPEER_ENDPOINT pcEndpoint,
  [out]          PWSTR           *ppwzContactData
);

Parâmetros

[in, optional] pcEndpoint

Ponteiro para uma estrutura PEER_ENDPOINT que contém o ponto de extremidade par sobre o qual obter informações de contato.

Se esse parâmetro for definido como NULL, as informações de contato do ponto de extremidade par atual serão obtidas.

[out] ppwzContactData

Ponteiro para um buffer de cadeia de caracteres Unicode com terminação zero que contém os dados de contato para o ponto de extremidade fornecido em pcEndpoint. Chame PeerFreeData para liberar os dados.

Retornar valor

Retorna S_OK se a função for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.

Código de retorno	Descrição
E_OUTOFMEMORY	Não há memória suficiente para dar suporte a essa operação.
E_INVALIDARG	Um dos argumentos é inválido.
PEER_E_NOT_FOUND	Os dados de contato solicitados não existem. Tente chamar PeerCollabRefreshEndpointData antes de fazer outra tentativa.

Comentários

Para recuperar dados de contato para um ponto de extremidade com êxito, um dos seguintes deve ocorrer:

• O ponto de extremidade deve ter sido obtido anteriormente chamando PeerCollabEnumEndpoints.
• O par local deve ter se inscrito no ponto de extremidade chamando PeerCollabSubscribeEndpointData.
• Os dados do ponto de extremidade devem ser atualizados chamando PeerCollabRefreshEndpointData com êxito.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	p2p.h
Biblioteca	P2P.lib
DLL	P2P.dll

Confira também

PEER_ENDPOINT

Funções da API de Colaboração de Pares