StartDiscovery method of the MSFT_SMStorageDiscovery class

Starts the Microsoft storage service discovery process.

Syntax

Uint32 StartDiscovery(
  [in]            String                host,
  [in, optional]  String                hostType,
  [in]            Boolean               forceRediscovery = false,
  [in]            Uint32                discoveryLevel,
  [in]            String                interopNamespace,
  [in]            String                username,
  [in]            String                password,
  [out]           MSFT_SMJob        REF Job,
  [out, optional] MSFT_SMExtendedStatus ExtendedStatus
);

Parameters

host [in]

The host to discover.

hostType [in, optional]

The type of the host to discover.

The possible values are.

host-resource ("host-resource")

smis-wmi ("smis-wmi")

smis-cimxml ("smis-cimxml")

forceRediscovery [in]

True to force the storage service to re-discover the host, even when the information about the host is already in the cache; otherwise, False.

discoveryLevel [in]

Indicates the level of discovery to perform.

The possible values are.

Top-Level (0)

Mid-Level (1)

AllExceptDiskDrives (2)

All (3)

interopNamespace [in]

The interoperation namespace used for the discovery process.

username [in]

The username used to authenticate with the SMI-S provider. If not provided, the storage service attempts to obtain these credentials from the configuration provider.

password [in]

The password used to authenticate with the SMI-S provider. If not provided, the storage service attempts to obtain these credentials from the configuration provider.

Job [out]

A reference to the MSFT_SMJob instance. May be NULL if the job is completed.

ExtendedStatus [out, optional]

An MSFT_SMExtendedStatus object that contains the results of calling this method.

Return value

Success (0)

Failed (1)

Job started (4096)

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2012
Namespace
Root\Microsoft\Windows\Storage\SM
MOF
MsftStrgMan.mof
DLL
StorageService.dll

See also

MSFT_SMStorageDiscovery