NWSMGetFirstExtension

Returns the first extension contained in buffer.

Syntax

  #include <smsutapi.h> 
   CCODE NWSMGetFirstExtension ( 
    void SM_HUGE                       *buffer, 
    UINT32                          *size,
    NWSM_EXTENSION_INFORMATION         SM_HUGE   **extension,   
    SMS_HANDLE SM_HUGE                *handle);
  

Parameters

buffer

(IN) Points to the start of the extension buffer.

size

(IN) Size of the extension buffer.

extension

(OUT) Points to the required extension information.

handle

(OUT) Points to the extension handle, used to maintain context 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

NWSMGetFirstExtension returns the first extension encountered in buffer. To get the next extension in buffer, call NWSMGetNextExtension. To end the retrieval of extensions call NWSMCloseExtension.

buffer should point to the start of the extension buffer. The size parameter should be set to the byte count of information present in the buffer parameter.

On errors NWSMCloseExtension need not be called.

See Also

NWSMGetNextExtension, NWSMCloseExtension