PNRPINFO_V2 structure (pnrpns.h)

The PNRPINFO_V1 structure is pointed to by the lpBlob member of the WSAQUERYSET structure.

Syntax

typedef struct _PNRPINFO_V2 {
  DWORD                      dwSize;
  LPWSTR                     lpwszIdentity;
  DWORD                      nMaxResolve;
  DWORD                      dwTimeout;
  DWORD                      dwLifetime;
  PNRP_RESOLVE_CRITERIA      enResolveCriteria;
  DWORD                      dwFlags;
  SOCKET_ADDRESS             saHint;
  PNRP_REGISTERED_ID_STATE   enNameState;
  PNRP_EXTENDED_PAYLOAD_TYPE enExtendedPayloadType;
  union {
    BLOB  blobPayload;
    PWSTR pwszPayload;
  };
} PNRPINFO_V2, *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

blobPayload

pwszPayload

Remarks

Starting with Windows Vista, please use the PNRPINFO_V2 structure.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2 [desktop apps only],Windows XP with SP1 with the Advanced Networking Pack for Windows XP
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	pnrpns.h

See also

PNRP and BLOB

PNRP and WSAQUERYSET

PNRPINFO_V2

WSAQUERYSET