Compartilhar via


Função PeerGraphGetRecord (p2p.h)

A função PeerGraphGetRecord recupera um registro específico com base na ID de registro especificada. O registro retornado deve ser liberado chamando PeerGraphFreeData.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetRecord(
  [in]  HGRAPH       hGraph,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

Parâmetros

[in] hGraph

Manipule para o grafo par.

[in] pRecordId

Ponteiro para a ID de registro a ser recuperada.

[out] ppRecord

Recebe o registro solicitado. Quando essa estrutura não for mais necessária, libere-a chamando PeerGraphFreeData.

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.
PEER_E_GRAPH_NOT_READY
O grafo par nunca foi sincronizado. Os registros não podem ser recuperados até que o grafo par seja sincronizado.
PEER_E_INVALID_GRAPH
O identificador para o grafo par é inválido.
PEER_E_NOT_INITIALIZED
O grafo par deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.
PEER_E_RECORD_NOT_FOUND
O registro especificado não foi encontrado.

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 paraWindows XP
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho p2p.h
Biblioteca P2PGraph.lib
DLL P2PGraph.dll

Confira também

PEER_RECORD

PeerGraphFreeData