IVdsIscsiTarget：：SetFriendlyName 方法（vds.h）

[從 Windows 8 和 Windows Server 2012 開始，虛擬磁碟服務 COM 介面被 Windows 儲存管理 API 取代。]

設定目標的友軍名稱。

語法

HRESULT SetFriendlyName(
  [in] LPWSTR pwszFriendlyName
);

[in] pwszFriendlyName

一個字串，指定要指派給目標的友軍名稱。這對應於 iSCSI 別名。

此方法可回傳標準 HRESULT 值，如 E_INVALIDARG 或 E_OUTOFMEMORY，以及 VDS 專屬的回傳值。它也能利用HRESULT_FROM_WIN32巨集回傳轉換後的系統錯誤碼。錯誤可能來自 VDS 本身，或來自所使用的底層 VDS 提供者。可能的回傳值包括以下幾項。

傳回碼/值	Description
S_OK	這個友善的名字成功定下。
VDS_S_NAME_TRUNCATED 0x00042700L	名稱成功設定，但因子系統限制而被截斷。設定的名稱可能與 pwszFriendlyName 參數中傳遞的名稱不符。
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	提供者的快取已經損壞。這表示供應商內部存在軟體或通訊問題，會快取連接裝置的資訊。呼叫者可以使用 IVdsHwProvider：：Reenumerate 方法，接著 IVdsHwProvider：：Refresh 方法來還原快取。
VDS_E_OBJECT_DELETED 0x8004240BL	目標物件已不存在。
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	另一項手術正在進行中;此操作必須完成前一操作才能繼續。
VDS_E_NOT_SUPPORTED 0x80042400L	此操作或參數組合不被此提供者支援。

此頁面對您有幫助嗎？