IVdsController::GetPortProperties メソッド (vds.h)

[アーティクル]
03/09/2024

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

指定したコントローラーポートのプロパティを返します。

構文

HRESULT GetPortProperties(
  [in]  SHORT         sPortNumber,
  [out] VDS_PORT_PROP *pPortProp
);

パラメーター

[in] sPortNumber

ポートの番号。ポート番号は永続的です。ポートには 0 から番号が付けられます。

[out] pPortProp

呼び出し元によって割り当てられ、渡された VDS_PORT_PROP 構造体のアドレス。 VDS は pwszFriendlyName および pwszIdentification メンバー文字列にメモリを割り当てます。呼び出し元は、CoTaskMemFree 関数を使用して文字列を解放する必要があります。

戻り値

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

リターンコード/値	Description
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	この戻り値は、配列に関する情報をキャッシュするプロバイダー内のソフトウェアまたは通信の問題を示します。キャッシュを復元するには、 IVdsHwProvider::Reenumerate メソッドの後に IVdsHwProvider::Refresh メソッドを使用します。
VDS_E_OBJECT_DELETED 0x8004240BL	コントローラーオブジェクトが存在しなくなりました。
VDS_E_NOT_SUPPORTED 0x80042400L	この操作またはパラメーターの組み合わせは、このプロバイダーではサポートされていません。

注釈

ポートの合計数を取得するには、 IVdsController::GetProperties メソッドを使用します。

要件

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