Función UpdateNtmsOmidInfo (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 UpdateNtmsOmidInfo actualiza la base de datos RSM con información de etiqueta inmediatamente después de escribir en el medio recién asignado.

Sintaxis

DWORD UpdateNtmsOmidInfo(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       labelType,
  [in] DWORD       numberOfBytes,
  [in] LPVOID      lpBuffer
);

Parámetros

[in] hSession

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

[in] lpMediaId

Identificador único de un fragmento de medio lógico.

[in] labelType

Tipo de etiqueta. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
NTMS_OMID_TYPE_FILESYSTEM_INFO
 El parámetro lpBuffer contiene una estructura NTMS_FILESYSTEM_INFO. Esta marca se usa para los medios que contienen sistemas de archivos.
NTMS_OMID_TYPE_RAW_LABEL
 El parámetro lpBuffer contiene los bytes sin formato de la etiqueta de la aplicación. Esta marca se usa para los medios que contienen etiquetas escritas por la aplicación.

[in] numberOfBytes

Número de bytes enviados en el parámetro lpBuffer .

[in] lpBuffer

Información de etiqueta. El formato de este parámetro depende del valor del parámetro labelType .

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 Se deniega el acceso a uno o varios objetos RSM.
ERROR_DATABASE_FAILURE
 Error en la consulta o actualización de la base de datos.
ERROR_INVALID_HANDLE
 El valor especificado en el parámetro hSession no es válido.
ERROR_INVALID_MEDIA
 No se puede recuperar la definición de medios lógicos de la base de datos.
ERROR_INVALID_PARTITION
 No se puede recuperar la definición del lado de la base de datos.
ERROR_INVALID_PARAMETER
 El parámetro lpMediaId es NULL.
ERROR_NOT_CONNECTED
 No se puede conectar al servicio RSM.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

La aplicación actualiza RSM con la información proporcionada por la función UpdateNtmsOmidInfo y RSM comprueba la información de la base de datos. La información de etiqueta se almacena en la base de datos RSM con el lado asociado a este LMID.

La función UpdateNtmsOmidInfo debe ejecutarse en el servidor RSM. La ejecución remota de esta función produce un error.

Para los medios de cinta lpBuffer debe apuntar a un búfer que contenga la etiqueta que se acaba de escribir en la cinta. Los datos de este búfer se pasan directamente al punto de entrada ClaimMediaLabel de cada MLL. Una de las MLL instaladas debe reconocer una etiqueta válida en estos datos.

Para los medios con sistemas de archivos, lpBuffer debe ser un puntero a un búfer que contenga la siguiente estructura:


typedef struct {
    WCHAR   FileSystemType[64];
    WCHAR   VolumeName[256];
    DWORD   SerialNumber;
} NTMS_FILESYSTEM_INFO;

RSM usa esta información del sistema de archivos como OMID. Las utilidades de formato (LDM, explorador, format.com, etc.) realizan eficazmente la misma funcionalidad que esta llamada. Una aplicación que realiza su propio formato o formato con un tipo de sistema de archivos de terceros solo debe tener que llamar a UpdateNtmsOmidInfo para los medios del sistema de archivos.

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

Funciones de administración de identificadores multimedia