WSALookupServiceBegin Parameter Values for Enumerating Clouds (Windows CE 5.0)
The following list shows the values to pass in the WSALookupServiceBegin (Windows Sockets) function when enumerating network clouds.
The lpqsRestrictions parameter references the WSAQUERYSET (Windows Sockets) structure. The following table shows the values that this structure must store while it resolves names.
Values Description dwSize Specifies the size of this structure. lpServiceClassID Must be SVCID_PNRPCLOUD. dwNameSpace Must be NS_PNRPCLOUD. lpNSProviderID Must be either NS_PROVIDER_PNRPCLOUD or NULL. lpBlob Must be either a pointer to a BLOB (Windows Sockets) structure or NULL. If it is NULL, default values are used. If it is set, lpBlob points to a PNRPINFO structure, and specific parameters in the PNRPINFO structure must be set.
Note All WSAQUERYSET members that are not specified in the table are reserved and must be set to NULL or zero (0) depending on the data type of the member.
PNRP uses the BLOB structure to pass data to the WSAQUERYSET structure during calls to several functions. For use with PNRP, the BLOB structure points to either a PNRPINFO structure or a PNRPCLOUDINFO structure.
If the lpBlob member of the WSAQUERYSET structure is set, values for PNRPINFO must also be set. The following table shows the PNRPINFO values to set when resolving names.
Values Description dwSize Specifies the size of this structure. Cloud Points to a structure that specifies criteria that you can use to filter search results. The Cloud.Scope member can be any of the following values: - PNRP_ANY_SCOPE
- PNRP_GLOBAL_SCOPE
- PNRP_SITE_LOCAL_SCOPE
- PNRP_LINK_LOCAL_SCOPE
If PNRP_ANY_SCOPE is specified, all clouds are returned. Otherwise, only clouds that match the Cloud.Scope are returned.
Note All PNRPINFO members that are not specified in the table are reserved and must be set to NULL or zero (0) depending on the data type of the member.
The dwControlFlags parameter controls the depth of the search. Specify the LUP_RETURN_* flag in dwControlFlag.
The following table shows the possible values for LUP_RETURN_* flags that are supported by PNRP.
Value Description LUP_RETURN_NAME Returns a name and context. LUP_RETURN_BLOB Returns the BLOB associated with this cloud.
See Also
Enumerating Clouds | Peer-to-Peer Application Development
Send Feedback on this topic to the authors