NWDPResCreateRefBasedOnSrsSAP

Generates a RMS reference by asking the Service Registry Service (SRS) for the nearest Resource Manager address

Local Servers: blocking

Remote Servers: blocking

NetWare Server: 4.11, 5.x

Platform: NLM, Windows 95, Windows 98

Service: Distributed Print

Syntax

#include <nwdp_res.h>  
  
N_EXTERN_LIBRARY (nint) NWDPResCreateRefBasedOnSrsSAP  (  
   NWDPAccessorRef   accessorRef,   
   pNWDPResRef       resRefPtr);

Parameters

accessorRef

(IN) Specifies the NWDPAccessorData structure whose fields are accessed by using the provided error macros.

resRefPtr

(OUT) Points to the NWDPResRef, the resource reference.

Return Values

0x00000000	N_SUCCESS
0xFFFFFFFE	NWDP_RC_INVALID_ACCESSOR
0xFFFFFFFF	N_FAILURE

Remarks

NWDPResCreateRefBasedOnSrsSAP does not provide you the security-level access necessary to add resources to a reference. You must call NWDPResCreateRefBasedOnFQN to add resources.

If the accessorRef parameter returns NWDP_EC_RESMAN_RESULT, the otherError field in the accessorRef parameter contains an error code from the Resource Manager. This error code correlates to the enumeration values found in the nwdp_err.h file.

If NWDPResCreateRefBasedOnSrsSAP returns N_FAILURE, the NWDPLibErrorMac (accessorRef) contains the following:

0x01000004L NWDP_EC_STDIO

0x01100001L NWDP_EC_RESMAN_RESULT

See Also

NWDPResCreateRefBasedOnAddr

NWDPResCreateRefBasedOnFQN