CM_Modify_Res_Des_Ex函式 (cfgmgr32.h)

[從Windows 8和Windows Server 2012開始，此函式已被取代。 請改用 CM_Modify_Res_Des 。]

CM_Modify_Res_Des_Ex函式會修改本機或遠端電腦上的指定資源描述元。

語法

CMAPI CONFIGRET CM_Modify_Res_Des_Ex(
  [out]          PRES_DES   prdResDes,
  [in]           RES_DES    rdResDes,
  [in]           RESOURCEID ResourceID,
  [in]           PCVOID     ResourceData,
  [in]           ULONG      ResourceLen,
  [in]           ULONG      ulFlags,
  [in, optional] HMACHINE   hMachine
);

參數

[out] prdResDes

要接收已修改之資源描述項控制碼的位置指標。

[in] rdResDes

要修改之資源描述元的呼叫端提供控制碼。 先前必須呼叫下列其中一個函式來取得此控制碼：

CM_Add_Res_Des

CM_Add_Res_Des_Ex

CM_Get_Next_Res_Des

CM_Get_Next_Res_Des_Ex

CM_Modify_Res_Des

CM_Modify_Res_Des_Ex

[in] ResourceID

呼叫端提供的資源類型識別碼。 這必須是Cfgmgr32.h中定義的ResType_前置常數之一。

[in] ResourceData

資源描述元的呼叫端提供指標，可以是資源描述元之下所列的其中一個結構， CM_Add_Res_Des_Ex函式 的 ResourceData描述之下。

[in] ResourceLen

ResourceData所指向之結構的呼叫端提供長度。

[in] ulFlags

未使用，必須是零。

[in, optional] hMachine

呼叫端提供的機器控制碼，是從先前呼叫取得 來CM_Connect_Machine。

注意從Windows 8和Windows Server 2012開始，不支援使用此函式來存取遠端電腦，因為此功能已移除。

 

傳回值

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

注意從 Windows 8 開始，CM_Modify_Res_Des_Ex會在 Wow64 案例中使用時傳回CR_CALL_NOT_IMPLEMENTED。 若要要求本機電腦上硬體資源的相關資訊，您必須使用硬體資源 API 實作應用程式的架構原生版本。 例如：AMD64 系統的 AMD64 應用程式。

 

備註

呼叫端提供的資源描述中繼資料會取代現有的資料。 針對 ResourceID 和 ResourceLen 指定的值不需要符合現有的資源描述元。

如果針對 ResourceID 指定的值 是ResType_ClassSpecific，則指定的資源描述元必須是與邏輯組態相關聯的最後一個描述元。

CM_Modify_Res_Des_Ex的呼叫端必須呼叫CM_Free_Res_Des_Handle，才能在不再需要資源描述元控制碼之後解除配置。

此函式的呼叫端必須具有 SeLoadDriverPrivilege。 Microsoft Windows SDK檔.) 說明 (許可權

存取遠端電腦的功能已在Windows 8和Windows Server 2012和更新版本的作業系統中移除，因此您無法在這些版本的 Windows 上執行時存取遠端電腦。

規格需求

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

另請參閱

CM_Modify_Res_Des