スタートアップオブジェクトとサービスオブジェクト

[アーティクル]
03/13/2025

[Windows 8 および Windows Server 2012 以降、Virtual Disk Service COM インターフェイスは、Windows Storage Management APIに置き換えられます。

VDS は、サービス関連のアクティビティを実行するためのオブジェクトを提供します。このトピックでは、各オブジェクトについて説明します。

サービスローダーオブジェクト

サービスローダーオブジェクトは、VDS を読み込んで初期化するためにアプリケーションによって使用されるメソッドを提供します。 VDS を使用できるように準備するには、アプリケーションで次の操作を実行する必要があります。

IVdsServiceLoader インターフェイスを返すサービスローダーオブジェクトのインスタンスを作成します。
IVdsServiceLoader::LoadService メソッドを呼び出して、サービスを読み込みます。

コード例については、「VDSの読み込み」を参照してください。

サービスオブジェクトによって公開されるメソッドを呼び出す前に、常にサービスを完全に初期化できるようにします。 IVdsService::IsServiceReady メソッドを使用して、読み込みプロセスの状態を確認します。初期化が完了するまで VDS オブジェクトの呼び出しをブロックするには、IVdsService::WaitForServiceReady メソッドを使用します。

次の表に、関連するインターフェイス、列挙型、および構造体を示します。

種類	要素
このオブジェクトによって常に公開されるインターフェイス	IVdsServiceLoaderをします。
関連付けられた列挙型	何一つ。
関連付けられた構造体	何一つ。

Service オブジェクト

サービスオブジェクトは、すべての VDS アプリケーションの中心となる多機能オブジェクトです。このオブジェクトを使用すると、呼び出し元は次の操作を実行できます。

サービスの初期化の状態を確認します。
VDS に登録されているすべてのハードウェアまたはソフトウェアプロバイダーを取得します。
未割り当てディスクに関するレポート。
ディスク上のボリュームに関連付けられているファイルシステムの種類とドライブ文字を返します。
未使用のユーザーモードパスとマウントされたフォルダーをレジストリから削除し、ディスクを更新します。
VDS 通知を受信します。
ホストを再起動します。
ローカルコンピューター上のファイバーチャネル HBA ポートまたは iSCSI イニシエーターアダプターを取得します。
ローカルコンピューター上のディスクとして公開されている LUN を削除用に安全に準備します。

VDS 通知構造体は、通知を受信するために VDS に登録されているすべてのアプリケーションにオブジェクト GUID を渡します。 IVdsService::GetObject メソッドを使用して、オブジェクト GUID をオブジェクトポインターに変換します。通知モデルの詳細については、「VDS 通知の」を参照してください。

次の表に、関連するインターフェイス、列挙型、および構造体を示します。

種類	要素
このオブジェクトによって常に公開されるインターフェイス	IVdsService, IVdsServiceHba, IVdsServiceIscsi, IVdsServiceUninstallDisk***.
常に実装されているが、アプリケーションに公開されないインターフェイス	IVdsAdminの
関連付けられた列挙型	VDS_QUERY_PROVIDER_FLAG, VDS_OBJECT_TYPE, VDS_SERVICE_FLAG, VDS_DRIVE_LETTER_FLAG, VDS_FILE_SYSTEM_FLAG, VDS_FILE_SYSTEM_PROP_FLAG.
関連付けられた構造体	VDS_SERVICE_PROP, VDS_FILE_SYSTEM_PROP, VDS_FILE_SYSTEM_TYPE_PROP, VDS_DRIVE_LETTER_NOTIFICATION, VDS_FILE_SYSTEM_NOTIFICATION, VDS_MOUNT_POINT_NOTIFICATION.

*Windows Server 2003: これらのインターフェイスは、Windows Server 2003 R2 までサポートされていません。

イニシエーターアダプターオブジェクト

イニシエーター・アダプター・オブジェクトは、VDS サービスのホスト・マシン上の iSCSI イニシエーター・アダプターをモデル化します。 VDS サービスは、ローカルコンピューター上のイニシエーターアダプターのみを表示できます。イニシエーターアダプターオブジェクトの役割は、ローカルコンピューターから iSCSI ターゲットへのログインセッションを管理することです。

次の表に、関連するインターフェイス、列挙型、および構造体を示します。

種類	要素
このオブジェクトによって常に公開されるインターフェイス	IVdsIscsiInitiatorAdapter* をします。
関連付けられた列挙型	VDS_ISCSI_LOGIN_TYPE. VDS_ISCSI_LOGIN_FLAG、 VDS_ISCSI_AUTH_TYPE.
関連付けられた構造体	VDS_ISCSI_INITIATOR_ADAPTER_PROP.

*Windows Server 2003: このインターフェイスは、Windows Server 2003 R2 までサポートされていません。

イニシエーターポータルオブジェクト

イニシエーターポータルオブジェクトは、iSCSI イニシエーター上の iSCSI イニシエーターポータルをモデル化します。イニシエーターポータルは、ホストコンピューターが iSCSI サブシステム上のポータルに接続する IP アドレスとポートの組み合わせです。イニシエーターポータルオブジェクトの役割は、MPIO パスのエンドポイントの 1 つとして機能し、IPSEC セキュリティ設定を構成することです。

次の表に、関連するインターフェイス、列挙型、および構造体を示します。

種類	要素
このオブジェクトによって常に公開されるインターフェイス	IVdsIscsiInitiatorPortal* をします。
関連付けられた列挙型	VDS_ISCSI_IPSEC_FLAG.
関連付けられた構造体	VDS_ISCSI_INITIATOR_PORTAL_PROP, VDS_ISCSI_IPSEC_KEY, VDS_IPADDRESS.

*Windows Server 2003: このインターフェイスは、Windows Server 2003 R2 までサポートされていません。

HBA ポートオブジェクト

HBA ポートオブジェクトは、ファイバーチャネルホストバスアダプター (HBA) ポートをモデル化します。

IVdsServiceHba::QueryHbaPorts メソッドを使用して、ローカルコンピューター上の VDS に認識されている HBA ポートを特定します。

次の表に、関連するインターフェイス、列挙型、および構造体を示します。

種類	要素
このオブジェクトによって常に公開されるインターフェイス	IVdsHbaPort*.
関連付けられた列挙型	VDS_HBAPORT_TYPE, VDS_HBAPORT_STATUS, VDS_HBAPORT_SPEED_FLAG.
関連付けられた構造体	VDS_HBAPORT_PROP.

*Windows Server 2003: このインターフェイスは、Windows Server 2003 R2 までサポートされていません。

VDS オブジェクトモデルの
IVdsServiceLoader::LoadService
VDS の読み込みの
IVdsService::GetObject
VDS 通知をする