NWDPResCreateRefBasedOnFQN

Generates an Resource Management Service (RMS) reference based on its fully qualified name (FQN)

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) NWDPResCreateRefBasedOnFQN  (  
   NWDPAccessorRef   accessorRef,    
   pNWDPNSrvFQN        brokerFqnPtr,   
   pNWDPResRef       resRefPtr);

Parameters

accessorRef

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

brokerFqnPtr

(IN) Points to the NWDPNSrvFQN structure containing the FQN of the broker object provided by the name service.

resRefPtr

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

Return Values

0x00000000	N_SUCCESS
0xFFFFFFFE	NWDP_RC_INVALID_ACCESSOR
0xFFFFFFFF	N_FAILURE

Remarks

Before calling NWDPResCreateRefBasedOnFQN, you must call NWDPNSrvSetNativeNDSContext once per application to assign a contextHandle to accessorRef.

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 NWDPResCreateRefBasedOnFQN returns N_FAILURE, the NWDPLibErrorMac (accessorRef) contains the following:

0x01000004L NWDP_EC_STDIO

0x01100001L NWDP_EC_RESMAN_RESULT

See Also

NWDPNSrvSetNativeNDSContext, NWDPResCreateRefBasedOnAddr, NWDPResCreateRefBasedOnSrsSAP