3.2.4.4.3.57 IVolumeClient3::Initialize (Opnum 68)

  • Article

The Initialize method initializes the dialog between the client and the server. This method MUST be the first call made by the client after connecting to the server.

 HRESULT Initialize(
   [in] IUnknown* notificationInterface,
   [out] unsigned long* ulIDLVersion,
   [out] DWORD* pdwFlags,
   [out] LdmObjectId* clientId,
   [in] unsigned long cRemote
 );

notificationInterface: Pointer to the client's IUnknown interface from which the server can query the IDMNotify interface that is used for sending notifications to the client.

ulIDLVersion: Revision of the Microsoft Interface Definition Language (MIDL) file with which the server was built.

pdwFlags: Bitmap of information flags about the server. The value of this field is generated by combining zero or more of the following applicable flags with a logical OR operation.

Value

Meaning

SYSFLAG_SERVER

0x00000001

Server is running on Windows 2000 Server operating system and Windows Server 2003 operating system.

SYSFLAG_ALPHA

0x00000002

Server is running on an Alpha processor.<224>

SYSFLAG_SYSPART_SECURE

0x00000004

System partition for the server is secure.<225>

SYSFLAG_NEC_98

0x00000008

Server is an NEC 98 computer, which supports assignment of drive letters A and B to partitions or volumes.<226>

SYSFLAG_NO_DYNAMIC

0x00000010

Server is a laptop and does not support dynamic disks.

SYSFLAG_WOLFPACK

0x00000020

Server is running on an MCS cluster.

SYSFLAG_IA64

0x00000040

Server is running on an Intel Itanium-based processor.

SYSFLAG_UNINSTALL_VALID

0x00000080

Server has an available and valid backup for uninstallation.

SYSFLAG_DYNAMIC_1394

0x00000100

Server supports converting IEEE 1394 attached disks to dynamic disks.

clientId: Pointer to the client's OID.

cRemote: If set to 0, indicates that the client is on the same machine as the server. Otherwise, the client is on a different machine than the server.

Return Values: The method MUST return 0 or a nonerror HRESULT on success, or an implementation-specific nonzero error code on failure (as specified in [MS-ERREF]; see also section 2.2.1 for HRESULT values predefined by the Disk Management Remote Protocol).

When the server receives an IVolumeClient3::Initialize message, it MUST process that message, as specified in IVolumeClient::Initialize (section 3.2.4.4.1.54).