共用方式為

CM_Get_Device_Interface_AliasW函式 (cfgmgr32.h)

  • 發行項

如果別名存在， CM_Get_Device_Interface_Alias 函式會傳回指定裝置介面實例的別名。

語法

CMAPI CONFIGRET CM_Get_Device_Interface_AliasW(
  [in]      LPCWSTR pszDeviceInterface,
  [in]      LPGUID  AliasInterfaceGuid,
  [out]     LPWSTR  pszAliasDeviceInterface,
  [in, out] PULONG  pulLength,
  [in]      ULONG   ulFlags
);

參數

[in] pszDeviceInterface

要擷取別名之裝置介面實例名稱的指標。 呼叫端通常會從 呼叫CM_Get_Device_Interface_List或 PnP 通知結構中收到此字串。

[in] AliasInterfaceGuid

GUID 的指標，指定要擷取之別名的介面類別。

[out] pszAliasDeviceInterface

指定緩衝區的指標，該指標會在成功傳回時指向包含別名名稱的字串。 當不再需要此字串時，呼叫端必須釋放此字串。

需要緩衝區。 否則，呼叫將會失敗。

[in, out] pulLength

提供 pszAliasDeviceInterface 中的字元計數，並接收保存別名裝置介面所需的字元數。

在輸入時，此參數必須大於 0。

[in] ulFlags

保留的。 請勿使用。

傳回值

如果作業成功，函式會傳回CR_SUCCESS。 否則，它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。

傳回碼 Description
CR_NO_SUCH_DEVICE_INTERFACE
 可能表示指定的介面類別沒有別名。
CR_OUT_OF_MEMORY
 記憶體不足，無法完成此作業。
CR_BUFFER_SMALL
 傳遞的緩衝區太小。

備註

如果裝置介面是由相同的基礎裝置公開，而且具有相同的介面參考字串，但屬於不同的介面類別，則裝置介面會被視為別名。

pszDeviceInterface 參數會指定屬於特定介面類別之特定裝置的裝置介面實例，並具有特定的參考字串。 CM_Get_Device_Interface_Alias 傳回相同裝置和參考字串的另一個裝置介面實例，但如果存在，則會傳回不同的介面類別。

例如，容錯磁碟區的函式驅動程式可以註冊並設定兩個裝置介面，其中一個容錯磁碟區介面類別和其中一個磁碟區介面類別。 另一個驅動程式可以使用其中一個介面的符號連結呼叫 CM_Get_Device_Interface_Alias ，並藉由指定介面類別來詢問另一個介面是否存在。

如果兩個裝置介面與 NULL 參考字串是由相同的基礎裝置公開，而且有不同的介面類別 GUID，則為別名。

規格需求

需求 值
最低支援的用戶端 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台 桌面
標頭 cfgmgr32.h (包含 Cfgmgr32.h)
程式庫 Cfgmgr32.lib