Returns the extension as specified by the extension tag.
#include <smsutapi.h>
CCODE NWSMGetExtension (
void SM_HUGE *buffer,
UINT32 size,
UINT32 extensionTag,
NWSM_EXTENSION_INFORMATION SM_HUGE **extension,
SMS_HANDLE *handle);
(IN) Points to the start of the extension buffer.
(IN) Size of the extension buffer.
(IN) Specifies the required extension information tag.
(OUT) Points to the required extension information.
(OUT) Points to the extension handle, used to maintain context information.
The following table lists the return values associated with the function.
Extension information field info can contain pointer type fields and hence internal allocation are made to return such elements. NWSMCloseExtension should be called to free the resources that are allocated for such purpose.
On errors NWSMCloseExtension need not be called.
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.
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.