Share via

3.4.5.2.5.1 IVdsServiceInitialization::Initialize (Opnum 3)

  • Article

 The Initialize method starts the initialization of the server.

 HRESULT Initialize(
   [in, unique, string] WCHAR* pwszMachineName
 );

pwszMachineName: Reserved; this parameter is not used.

Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success, or return an implementation-specific nonzero error code to indicate failure. For the HRESULT values predefined by the Virtual Disk Service Remote Protocol, see section 2.2.3.

When the server receives this message, it MUST initialize the server and return a success value (HRESULT of 0x00000000) if the operation is successful, or VDS_E_INITIALIZED_FAILED (HRESULT of 0x80042401) if the operation failed. For more information about initialization, see section 3.4.3.

If the IVdsServiceLoader::LoadService method is used to instantiate the server, there is no need to QueryInterface for the IVdsServiceInitialization interface, or to call IVdsServiceInitialization::Initialize. See IVdsServiceLoader::LoadService.