Función IdentifyNtmsSlot (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 IdentifyNtmsSlot identifica los medios de la ranura especificada en una biblioteca. El comando devuelve cuando se completa la identificación.

Sintaxis

DWORD IdentifyNtmsSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpSlotId,
  [in] DWORD       dwOption
);

Parámetros

[in] hSession

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

[in] lpSlotId

Identificador único del objeto de ranura que se va a identificar.

[in] dwOption

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

Valor Significado
NTMS_DISMOUNT_DEFERRED
 Deje el medio en la unidad una vez completada la identificación de medios, como si se hubiera desmontado con la opción "diferida".
NTMS_DISMOUNT_IMMEDIATE
 Desmonte el medio de la unidad una vez completada la identificación del medio.

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_INVALID_HANDLE
 El valor especificado en el parámetro hSession no es válido.
ERROR_INVALID_PARAMETER
 El identificador de ranura o dwOption no es válido.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

Si la ranura está vacía, la función devuelve ERROR_SUCCESS, pero no aparecen registros multimedia nuevos.

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

InventoryNtmsLibrary

Funciones de control de biblioteca