NWSMGetNextExtension

Continues the extension parsing process started by NWSMGetFirstExtension.

Syntax

  #include <smsutapi.h> 
   
  CCODE NWSMGetNextExtension(   
    SMS_HANDLE SM_HUGE                 *handle,
    NWSM_EXTENSION_INFORMATION SM_HUGE **extension);
  
  

Parameters

handle

(IN) Points to the extension handle as returned by NWSMGetFirstExtension.

extension

(OUT) Points to the extension information.

Return Values

The following table lists the return values associated with the function.

0x00000000

Successful

0xFFFBFFFD

NWSMUT_INVALID_PARAMETER

0xFFFBFFFB

NWSMUT_OUT_OF_MEMORY

0xFFFBFFF8

NWSMUT_NO_MORE_EXTENSIONS

Remarks

NWSMGetNextExtension returns the next extension contained in buffer passed in to NWSMGetFirstExtension.

On errors NWSMCloseExtension need not be called.

Using extension handles as obtained from NWSMGetExtension can lead to unpredictable results.

Application should copy the extension information as the pointer is reused by the call to get the next extension. To free the extension buffer call NWSMCloseExtension.

See Also

NWSMGetFirstExtension