IVdsLunNumber::GetLunNumber メソッド (vdshwprv.h)

[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。

LUN の LUN 番号を取得します。

構文

HRESULT GetLunNumber(
  [out] ULONG *pulLunNumber
);

パラメーター

[out] pulLunNumber

LUN 番号を受け取る変数のアドレス。 この値は必須であり、 NULL にすることはできません。

戻り値

このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、 VDS 固有の戻り値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。

リターン コード	説明
S_OK	メソッドは正常に完了しました。

解説

このメソッドは、VDS ハードウェア プロバイダーが LUN に割り当てた LUN 番号を返します。 この番号は、ディスク アレイ内の LUN を識別します。 ディスクの SCSI アドレスの "論理ユニット番号" と同じではありません。 ディスク アレイ内の各 LUN には、1 つの LUN 番号が割り当てられます。

DiskRAID ユーティリティは、サブシステム内の LUN を列挙するときに、各 LUN に独自のインデックスを割り当てるので、このメソッドが存在します。 ただし、ハードウェア プロバイダーが LUN を別の順序で列挙すると、DiskRAID が実行されるたびに、これらのインデックスが変更される可能性があります。 これは、エンド ユーザーに混乱を招く可能性があります。 独自の (プロバイダー割り当て済み) LUN 番号を持つディスク アレイの場合、このメソッドは呼び出し元に LUN 番号を DiskRAID によって割り当てられた LUN インデックスにマップする機能を提供します。

サブシステムが LUN 番号付けをサポートしている場合は、VDS_SUB_SYSTEM_PROPまたはVDS_SUB_SYSTEM_PROP2構造体の ulFlags メンバーに VDS_SF_SUPPORTS_LUN_NUMBER フラグを設定することで、このサポートを示すことができます。 このフラグの詳細については、「 VDS_SUB_SYSTEM_FLAG 列挙」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	vdshwprv.h
Library	Uuid.lib

こちらもご覧ください

IVdsLunNumber