NWSMTSBuildResourceList

Updates the TSA's internal list of primary resources.

Syntax

  #include <smstsapi.h> 
   
  CCODE NWSMTSBuildResourceList (
     UINT32   connection);
  

Parameters

connection

(IN) Specifies the connection information returned by NWSMTSConnectToTargetService or NWSMTSConnectToTargetServicEx.

Return Values

See Section 9.3, Target Service Return Values for more information.

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

0x00000000

Successful

0xFFFDFFB9

NWSMTS_UNSUPPORTED_FUNCTION

0xFFFDFFC9

NWSMTS_OUT_OF_MEMORY

0xFFFDFFE7

NWSMTS_INVALID_CONNECTION_HANDL

0xFFFDFFE8

NWSMTS_GET_VOL_NAME_SPACE_ERR

0xFFFDFFE9

NWSMTS_GET_SERVER_INFO_ERR

0xFFFDFFED

NWSMTS_GET_DATA_STREAM_NAME_ERR

0xFFFEFFFF

NWSMDR_INVALID_CONNECTION

Remarks

Before NWSMTSBuildResourceList is called, the engine must be connected to a TSA and Target Service.

The engine calls NWSMTSBuildResourceList to ensure the TSA's resource list is up-to-date. The TSA will only scan what is in its internal primary resource list. If a virtual NCP server name is selected, the list of primary resources in the pool associated with the virtual NCP server is built. If a node name is selected, the list of non-cluster resources on the server will be built.

Do not call NWSMTSBuildResourceList if there are any active scans or if NWSMTSOpenDataSetForRestore still has data sets open.

See Also

NWSMTSGetNameSpaceTypeInfo, NWSMTSGetOpenModeOptionString, NWSMTSGetTargetResourceInfo, NWSMTSGetTargetScanTypeString, NWSMTSGetTargetSelectionTypeStr, NWSMTSListSupportedNameSpaces, NWSMTSScanDataSetBegin, NWSMTSScanSupportedNameSpaces, NWSMTSScanTargetServiceResource