Compartilhar via


Função PeerGraphUpdateRecord (p2p.h)

A função PeerGraphUpdateRecord atualiza um registro no grafo par e, em seguida, inunda o registro para cada nó no grafo par.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphUpdateRecord(
  [in] HGRAPH       hGraph,
  [in] PPEER_RECORD pRecord
);

Parâmetros

[in] hGraph

Manipule para o grafo par.

[in] pRecord

Ponteiro para uma estrutura PEER_RECORD que contém os novos dados do registro.

Valor retornado

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 atualizados até que o grafo 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.

Comentários

Os seguintes membros da estrutura PEER_RECORD podem ser modificados:

  • pwzAttributes
  • ftExpiration - a expiração só pode ser aumentada
  • data
  • pwzLastModified - preenchido por padrão se nenhum valor for fornecido

Exemplos

Este snippet de código mostra como atualizar um registro.

// dwFlags is updated to automatically refresh the record if it is about to expire.
    record.dwFlags = PEER_RECORD_FLAG_AUTOREFRESH;
    // The record data is updated with the string contained in pwzUserData.
    record.data.cbData = (ULONG) wcslen(pwzUserData) * sizeof(WCHAR);
    record.data.pbData = (PBYTE) pwzUserData;

    HRESULT hr = PeerGraphUpdateRecord(hGraph, &record;);

    if (FAILED(hr))
    {
        // Insert your code to handle the error here.
    }
    else
    {
        // Insert your application specific code here.
    }

Requisitos

   
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