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
Minimum supported client |
Windows XP with SP2 [desktop apps only] |
Minimum supported server |
Windows Server 2008 [desktop apps only] |
Version |
Windows XP with SP1 with the Advanced Networking Pack for Windows XP |
Header |
Pnrpns.h |