ピア名の登録解除

ピア名の登録を解除すると、登録済みの名前がピア名解決プロトコル (PNRP) クラウドから削除されます。

ピア名の登録解除

ピア名の登録を解除するには、 WSASetService を呼び出します。 essOperation パラメーターの値は RNRSERVICE_DELETE である必要があります。 このトピックの次のセクションのガイドラインを使用して、 WSASetService パラメーターと WSAQUERYSET 構造体に必要な構成を行います。

WSASetService の構成

アプリケーションが WSASetService を呼び出す場合、パラメーターは次の仕様に従って構成する必要があります。

• essOperation には RNRSERVICE_DELETE の値が必要です。
• dwFlags は ゼロ (0) である必要があります。
• lpqsRegInfo は WSAQUERYSET 構造体を指す必要があります。この構造体は、このトピックの次のセクションのガイドラインを使用して構成する必要があります。

WSAQUERYSET の構成

WSAQUERYSET 構造体は、次の仕様に従って構成する必要があります。

• dwSize では、 WSAQUERYSET 構造体のサイズを指定する必要があります。
• lpszServiceInstanceName は、登録解除されているピア名を指す必要があります。
• lpBlob はPNRPINFO 構造体を指している必要があります。
• lpcsaBuffer は アドレス一覧を指す必要があります。

注意

残りのメンバーについては、 PNRP と WSASetService に関するページを参照してください。

 

ピア名の登録解除の例

次のコード スニペットは、WSAQUERYSET 構造体を使用して WSASetService を呼び出すときに正しい情報を提供することでピア名の登録を解除する方法を示しています。

#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;
}