RegisterServiceMethodEx

Register a callable method with the NetWare HTTP Stack, which is invoked when the tag is encountered at the beginning of the relative URL path.

Syntax

    #include <httpexp.h>
    
    BOOL RegisterServiceMethod (
      void   *pzServiceName,
      void   *pServiceTag,
      int     serviceTagLength,
      void   *pTableOfContentsStruc,
      UINT32  requestedRights,
      void   *pReserved,
      UINT32 (*pServiceMethod)(
                  HINTERNET  hndl,
    	              void      *pExtraInfo,
                  UINT32     szExtraInfo,
                  UINT32     InformationBits),
      void   *pRTag,
      UINT32 *pReturnCode);

Parameters

pzServiceName
(IN) Points to an ASCIIZ string describing the Service Method.
pServiceTag
(IN) Points to the ASCII string representing the method.
serviceTagLength
(IN) Specifies the length in bytes of the Service Tag.
pTableOfContentsStruc
(IN) Points to an optional TOCregistration structure which adds your entry to the table of contents on the entry page of NetWare Remote Manager. See also Section 1.1, Registering Your Service.
requestedRights
(IN) Specifies the rights required for the service method to be called. If the method wants to handle all rights issues, a zero may be passed. For information on the rights settings, please refer to Section 6.5, Information Bits.
pReserved
(IN) Reserved for future use. Must be set to zero.
pServiceMethod
(IN) Points to the function to invoke when the first component of a relative URL path is equivalent to the Service Tag. The callback method is passed the following parameters:
  • hndl—(IN) Specifies the HTTP stack handle.
  • pExtraInfo—(IN) Points to any data following the relative URL, or to the break character if encountered in the relative URL.
  • szExtraInfo—(IN) Specifies the size of the pExtraInfo buffer, in bytes.
  • InformationBits—(IN) See Section 6.5, Information Bits.
pRTag
(IN) Points to a NetWare resource tag.
pReturnCode
(I/O) Points to where the error code is returned, if registration fails.

Return Values

Constant

Description

TRUE

The Service Method has been registered.

FALSE

The Service Method failed registration. For failure reason, see pReturnCode.

Remarks

The RegisterServiceMethodEx function allows a table of contents structure to be passed, allowing the registered method to appear in the table of contents on the front page of NetWare Remote Manager.

See Also

RegisterServiceMethod, DeRegisterServiceMethod