Cancelar o registro de um nome de par

Quando você cancela o registro de um nome de par, um nome registrado é removido de uma nuvem PNRP (protocolo PNRP).

Cancelar o registro de um nome de par

Para cancelar o registro de um nome de par, chame WSASetService. O parâmetro essOperation deve ter um valor de RNRSERVICE_DELETE. Use as diretrizes nas seções a seguir deste tópico para fazer as configurações necessárias para os parâmetros WSASetService e a estrutura WSAQUERYSET .

Configurando o WSASetService

Quando um aplicativo chama WSASetService, os parâmetros devem ser configurados de acordo com as seguintes especificações:

• essOperation deve ter um valor de RNRSERVICE_DELETE.
• dwFlags deve ser zero (0).
• lpqsRegInfo deve apontar para uma estrutura WSAQUERYSET , que deve ser configurada usando as diretrizes na seção a seguir deste tópico.

Configurando o WSAQUERYSET

A estrutura WSAQUERYSET deve ser configurada de acordo com as seguintes especificações:

• dwSize deve especificar o tamanho da estrutura WSAQUERYSET .
• lpszServiceInstanceName deve apontar para o nome do par que está sendo cancelado.
• LpBlob deve apontar para uma estrutura PNRPINFO .
• lpcsaBuffer deve apontar para a lista de endereços.

Observação

Os membros restantes são descritos em PNRP e WSASetService.

 

Um exemplo de cancelar o registro de um nome de par

O snippet de código a seguir mostra como cancelar o registro de um nome de par fornecendo as informações corretas ao chamar WSASetService usando a estrutura WSAQUERYSET .

#define UNICODE
#include <initguid.h>
#include <p2p.h>

#pragma comment(lib, "ws2_32.lib")

//-------------------------------------------------------------------------
// Function: PnrpUnregister
//
// Purpose:  Unregister the given name from a PNRP cloud
//
// Arguments:
//   pwzIdentity : identity string originally used to register the name
//   pwzName     : name to unregister from PNRP
//   pwzCloud    : name of the cloud to unregister from, NULL = global cloud
//
// Returns:  HRESULT
//
HRESULT PnrpUnregister(PWSTR pwzIdentity, PWSTR pwzName, PWSTR pwzCloud)
{
    HRESULT         hr = S_OK;
    PNRPINFO        pnrpInfo = {0};
    BLOB            blPnrpData = {0};
    WSAQUERYSET     querySet = {0};
    INT             iRet;

    //
    // build the WSAQUERYSET required to unregister
    //
    pnrpInfo.dwSize = sizeof(pnrpInfo);
    pnrpInfo.dwLifetime = 60 * 60 * 8; // 8 hours
    pnrpInfo.lpwszIdentity = pwzIdentity;

    blPnrpData.cbSize = sizeof(pnrpInfo);
    blPnrpData.pBlobData = (BYTE*)&pnrpInfo;

    querySet.dwSize = sizeof(querySet);
    querySet.dwNameSpace = NS_PNRPNAME;
    querySet.lpServiceClassId = (LPGUID)&SVCID_PNRPNAME;
    querySet.lpszServiceInstanceName = pwzName;
    querySet.lpszContext = pwzCloud;
    querySet.lpBlob = &blPnrpData;

    // unregister the name with PNRP
    iRet = WSASetService(&querySet, RNRSERVICE_DELETE, 0);
    if (iRet != 0)
    {
        hr = HRESULT_FROM_WIN32(WSAGetLastError());
    }

    return hr;
}