Función DecommissionNtmsMedia (ntmsapi.h)

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La función DecommissionNtmsMedia mueve un lado del estado Disponible al estado Retirado.

Sintaxis

DWORD DecommissionNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId
);

[in] hSession

Identificador de la sesión devuelta por la función OpenNtmsSession .

[in] lpMediaId

Identificador único de un lado de un elemento de medios físicos.

Valor	Significado
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS al grupo de medios de comunicación se deniega. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad. Windows XP: NTMS_MODIFY_ACCESS al grupo de medios de comunicación se deniega. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad.
ERROR_DATABASE_FAILURE	La base de datos es inaccesible o está dañada.
ERROR_DATABASE_FULL	La base de datos está llena.
ERROR_INVALID_HANDLE	Falta el identificador de sesión o no es válido.
ERROR_INVALID_MEDIA	El identificador multimedia no es válido.
ERROR_INVALID_MEDIA_POOL	El grupo de medios para medios no es válido.
ERROR_INVALID_PARAMETER	Falta el identificador multimedia.
ERROR_INVALID_STATE	El medio no está en estado Disponible.
ERROR_NOT_ENOUGH_MEMORY	Error de asignación durante el procesamiento.
ERROR_SUCCESS	La función se realizó correctamente.

RSM reconoce los medios retirados por la función DecommissionNtmsMedia , pero el medio retirado no contiene ningún dato y nunca se usa de nuevo.

Solo se pueden retirar los medios que están en estado Disponible. Para obtener más información, vea Ciclo de vida multimedia.

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ntmsapi.h
Library	Ntmsapi.lib
Archivo DLL	Ntmsapi.dll