Função PeerGraphAddRecord (p2p.h)

A função PeerGraphAddRecord adiciona um novo registro a um grafo par. Um registro adicionado com essa função é enviado para cada nó em um grafo par.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphAddRecord(
  [in]  HGRAPH       hGraph,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Parâmetros

[in] hGraph

Identificador para um grafo par.

[in] pRecord

Ponteiro para um registro a ser adicionado.

[out] pRecordId

Especifica a ID do registro que identifica exclusivamente um registro em um grafo par.

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_ACCESSDENIED	Não é possível acessar um grafo par.
E_INVALIDARG	Um dos parâmetros não é válido.
E_OUTOFMEMORY	Não há memória suficiente para executar uma operação especificada.
PEER_E_GRAPH_NOT_READY	Um grafo não está sincronizado. Os registros não podem ser adicionados até que o grafo par seja sincronizado.
PEER_E_GRAPH_SHUTTING_DOWN	PeerGraphClose foi chamado.
PEER_E_INVALID_ATTRIBUTES	Os atributos especificados não correspondem ao esquema.
PEER_E_INVALID_GRAPH	O identificador para um grafo par é inválido.
PEER_E_MAX_RECORD_SIZE_EXCEEDED	O registro excede o tamanho máximo permitido por um grafo par.
PEER_E_NOT_INITIALIZED	O grafo deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.

Comentários

Os seguintes membros da estrutura PEER_RECORD devem conter valores válidos:

• dwSize.
• tipo.
• ftExpiration – deve ser posterior à hora do grafo atual e deve ser especificado no tempo de par usando PeerGraphUniversalTimeToPeerTime.

Os membros a seguir da estrutura PEER_RECORD são opcionais. Defina-os como NULL se eles não forem usados pelo seu aplicativo:

• data
• pwzAttributes
• securityData
• Dwversion

Se qualquer um dos seguintes membros for NULL, a API de Grafo de Pares executará o comportamento padrão especificado:

• pwzCreatorId – usa a ID de par passada para PeerGraphCreate ou PeerGraphOpen.
• pwzModifiedById – usa pwzCreatorId.

Os membros a seguir não podem ser especificados; qualquer valor usado é substituído pela infraestrutura do Peer Graphing:

• ID.
• ftCreation – usa tempo de par.
• ftLastModified – usa o tempo de par.

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

PeerGraphDelete

PeerGraphGetEventData

PeerGraphUpdate