PNRPINFO_V2 structure

The PNRPINFO_V2 structure is pointed to by the lpBlob member of the WSAQUERYSET structure, and provides support for application-specific opaque data.

Syntax

typedef struct _PNRPINFO {
  DWORD                    dwSize;
  LPWSTR                   lpwszIdentity;
  DWORD                    nMaxResolve;
  DWORD                    dwTimeout;
  DWORD                    dwLifetime;
  PNRP_RESOLVE_CRITERIA    enResolveCriteria;
  DWORD                    dwFlags;
  SOCKET_ADDRESS           saHint;
  PNRP_REGISTERED_ID_STATE enNameState;
  DWORD                    enExtendedPayloadType;
  union {
    BLOB  blobPayload;
    PWSTR pwszPayload;
  };
} PNRPINFO_V2, PNRPINFO, *PPNRPINFO, *PPNRPINFO_V2;

Members

• dwSize
  Specifies the size of this structure.

• lpwszIdentity
  Points to the Unicode string that contains the identity.

• nMaxResolve
  Specifies the requested number of resolutions.

• dwTimeout
  Specifies the time, in seconds, to wait for a response.

• dwLifetime
  Specifies the number of seconds between refresh operations. Must be 86400 (24 * 60 * 60 seconds).

• enResolveCriteria
  Specifies the criteria used to resolve matches. PNRP can look for the first matching name, or attempt to find a name that is numerically close to the service location. Valid values are specified by PNRP_RESOLVE_CRITERIA.

• dwFlags
  Specifies the flags to use for the resolve operation. The valid value is:

  Value	Description
  PNRPINFO_HINT	Indicates that the saHint member is used. The hint influences how the service location portion of the PNRP ID is generated; it also influences how names are resolved, and specifies how to select between multiple peer names.

   

• saHint
  Specifies the IPv6 address to use for the location. The dwFlags member must be PNRPINFO_HINT.

• enNameState
  Specifies the state of the registered ID. This value is reserved and must be set to zero (0).

• enExtendedPayloadType
  The type of the extended data payload specified in the following union structure.

  Value	Meaning
  PNRP_EXTENDED_PAYLOAD_TYPE_NONE	No extended payload is present.
  PNRP_EXTENDED_PAYLOAD_TYPE_BINARY	The extended payload is binary data.
  PNRP_EXTENDED_PAYLOAD_TYPE_STRING	The extended payload is Unicode string data.

   

  Note  The maximum extended payload size is 4k.

   

• blobPayload
  BLOB that contains application-specific binary data. This field is present only when enExtendedPayloadType is set to PNRP_EXTENDED_PAYLOAD_TYPE_BINARY.

• pwszPayload
  Pointer to application-specific zero-terminated Unicode string data. This field is present only when enExtendedPayloadType is set to PNRP_EXTENDED_PAYLOAD_TYPE_STRING.

Requirements

See also

PNRPINFO_V1

PNRP and BLOB

PNRP and WSAQUERYSET

WSAQUERYSET