Función ChangeNtmsMediaType (ntmsapi.h)

  • Artículo

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

La función ChangeNtmsMediaType mueve el PMID especificado al grupo de medios de destino especificado y establece el identificador de tipo de medio de PMID en el tipo de medio del grupo de medios de destino.

Sintaxis

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

Parámetros

[in] hSession

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

[in] lpMediaId

Identificador único del medio físico que se va a mover.

[in] lpPoolId

Identificador único del grupo de medios desde el que se va a asignar el medio.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS al equipo o al grupo de medios se deniega. Otros errores de seguridad 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.
ERROR_DATABASE_FAILURE
 La base de datos no es accesible 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_POOL
 El identificador del grupo de medios no es válido.
ERROR_INVALID_PARAMETER
 Falta el grupo de medios o el identificador de medios.
ERROR_NOT_ENOUGH_MEMORY
 Error de asignación durante el procesamiento.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

La función ChangeNtmsMediaType usa la misma directiva para mover medios que la función MoveToNtmsMediaPool (los medios no reconocidos solo se pueden mover al grupo gratuito).

Requisitos

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

Consulte también

AddNtmsMediaType

DeleteNtmsMediaType

Funciones de Media Services