Compartilhar via


Função PeerGraphDeleteRecord (p2p.h)

A função PeerGraphDeleteRecord marca um registro como excluído em um grafo par. O registro não está disponível em um nó local para chamadas de função, por exemplo, chamadas para PeerGraphGetRecord e PeerGraphEnumRecords.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphDeleteRecord(
  [in] HGRAPH     hGraph,
  [in] const GUID *pRecordId,
  [in] BOOL       fLocal
);

Parâmetros

[in] hGraph

Manipule para um grafo par.

[in] pRecordId

Ponteiro para uma ID de registro a ser excluída.

[in] fLocal

Especifique TRUE para remover um registro de apenas um banco de dados local sem notificar o restante de um grafo par sobre a alteração. Especifique FALSE para excluir o registro de um grafo par inteiro.

Nota Especificar TRUE não impede que um registro seja adicionado novamente durante a próxima sincronização de grafo com um vizinho. Especificar TRUE só será eficaz se PEER_SECURITY_INTERFACE for especificado em uma chamada para PeerGraphOpen ou PeerGraphCreate e somente se PEER_SECURITY_INTERFACE contiver uma função PFNPEER_VALIDATE_RECORD que retorna PEER_E_INVALID_RECORD ao validar o registro.
 

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.
PEER_E_GRAPH_NOT_READY
O grafo par não está sincronizado. Os registros não podem ser excluídos até que o grafo seja sincronizado.
PEER_E_INVALID_GRAPH
O identificador para um 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 pode ser 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

PeerGraphAddRecord

PeerGraphEnumRecords

PeerGraphGetRecord

PeerGraphUpdateRecord