Compartir a través de

función CM_Request_Device_EjectA (cfgmgr32.h)

  • Artículo

La función CM_Request_Device_Eject prepara una instancia de dispositivo local para la eliminación segura, si el dispositivo es extraíble. Si el dispositivo se puede expulsar físicamente, será.

Sintaxis

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
);

Parámetros

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al equipo local.

[out, optional] pVetoType

(Opcional). Si no es NULL, esto apunta a una ubicación que, si se produce un error en la solicitud de eliminación, recibe un valor con tipo PNP_VETO_TYPE que indica el motivo del error.

[out, optional] pszVetoName

(Opcional). Si no es NULL, se trata de un puntero proporcionado por el autor de la llamada a un búfer de cadena que recibe una cadena de texto. El tipo de información que proporciona esta cadena depende del valor recibido por pVetoType. Para obtener información sobre estas cadenas, consulte PNP_VETO_TYPE.

[in] ulNameLength

(Opcional). Valor proporcionado por el autor de la llamada que representa la longitud del búfer de cadena proporcionado por pszVetoName. Debe establecerse en MAX_PATH.

[in] ulFlags

No se usa.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

Si pszVetoName es NULL, el administrador de PnP muestra un mensaje al usuario que indica que se quitó el dispositivo o, si se produjo un error en la solicitud, identificando el motivo del error. Si pszVetoName no es NULL, el administrador de PnP no muestra un mensaje. (Tenga en cuenta, sin embargo, que solo para Microsoft Windows 2000, el administrador de PnP muestra un mensaje aunque pszVetoName no sea NULL, si se establece la funcionalidad CM_DEVCAP_DOCKDEVICE del dispositivo).

Los autores de llamadas de CM_Request_Device_Eject a veces requieren SeUndockPrivilege o SeLoadDriverPrivilege, como se indica a continuación:

  • Si se establece la funcionalidad de CM_DEVCAP_DOCKDEVICE del dispositivo (el dispositivo es un dispositivo de "acoplamiento"), los llamadores deben tener SeUndockPrivilege. (No se requiere SeLoadDriverPrivilege ).
  • Si no se establece la funcionalidad de CM_DEVCAP_DOCKDEVICE del dispositivo (el dispositivo no es un dispositivo "dock" ) y si el proceso de llamada no es interactivo o se ejecuta en un entorno multiusuario en una sesión no conectada a la consola física (por ejemplo, una sesión remota de Terminal Services), los autores de llamada de esta función deben tener SeLoadDriverPrivilege.
Los privilegios se describen en la documentación de Microsoft Windows SDK.

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados al equipo local, consulte CM_Get_Child.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado cfgmgr32.h (incluya Cfgmgr32.h)
Library Cfgmgr32.lib

Consulte también

CM_Get_Child
CM_Query_And_Remove_SubTree
CM_Query_And_Remove_SubTree_Ex
CM_Request_Device_Eject_Ex