CM_Request_Device_EjectA函式 (cfgmgr32.h)

如果裝置是可移動的， CM_Request_Device_Eject 函式會準備本機裝置實例以進行安全移除。 如果裝置可以實際退出，則會是 。

語法

CMAPI CONFIGRET CM_Request_Device_EjectA(
  [in]            DEVINST        dnDevInst,
  [out, optional] PPNP_VETO_TYPE pVetoType,
  [out, optional] LPSTR          pszVetoName,
  [in]            ULONG          ulNameLength,
  [in]            ULONG          ulFlags
);

參數

[in] dnDevInst

呼叫端提供的裝置實例句柄，該句柄系結至本機計算機。

[out, optional] pVetoType

(Optional.) 如果不是 NULL，這會指向移除要求失敗時收到指出失敗原因 的PNP_VETO_TYPE型別值。

[out, optional] pszVetoName

(Optional.) 如果不是 NULL，這是接收文字字串之字串串緩衝區的呼叫端指標。 此字串所提供的資訊類型取決於 pVetoType 所收到的值。 如需這些字串的相關信息，請參閱 PNP_VETO_TYPE。

[in] ulNameLength

(Optional.) Caller 提供的值，代表 pszVetoName 所提供的字串緩衝區長度。 這應該設定為 MAX_PATH。

[in] ulFlags

未使用。

傳回值

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

備註

如果 pszVetoName 為 NULL，則 PnP 管理員會顯示訊息給使用者，指出裝置已移除，或如果要求失敗，請識別失敗的原因。 如果 pszVetoName 不是 NULL，則 PnP 管理員不會顯示訊息。 不過， (請注意，只有 Microsoft Windows 2000 的 PnP 管理員會顯示訊息，即使 pszVetoName 不是 NULL，如果裝置的CM_DEVCAP_DOCKDEVICE功能已設定。)

CM_Request_Device_Eject的呼叫端有時需要 SeUndockPrivilege 或 SeLoadDriverPrivilege，如下所示：

• 如果裝置的CM_DEVCAP_DOCKDEVICE功能設定 (裝置是「停駐」裝置) ，呼叫端必須具有 SeUndockPrivilege。 (SeLoadDriverPrivilege 並非必要。)
• 如果未設定裝置的CM_DEVCAP_DOCKDEVICE功能， (裝置不是「停駐」裝置) ， 而且 如果呼叫程式不是互動式，或是在未連結至實體控制台的會話中執行， (例如遠端終端機服務會話) ，則此函式的呼叫端必須具有 SeLoadDriverPrivilege。

Microsoft Windows SDK 檔中會說明許可權。

如需使用系結至本機計算機的裝置實例句柄的相關信息，請參閱 CM_Get_Child。

規格需求

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

另請參閱

CM_Get_Child
CM_Query_And_Remove_SubTree
CM_Query_And_Remove_SubTree_Ex
CM_Request_Device_Eject_Ex