Función CreateNtmsMediaPool (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 CreateNtmsMediaPool crea un nuevo grupo de medios de aplicaciones.

Sintaxis

DWORD CreateNtmsMediaPool(
  [in]  HANDLE                hSession,
  [in]  LPCTSTR               lpPoolName,
  [in]  LPNTMS_GUID           lpMediaType,
  [in]  DWORD                 dwAction,
  [in]  LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [out] LPNTMS_GUID           lpPoolId
);

Parámetros

[in] hSession

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

[in] lpPoolName

Nombre del nuevo grupo de medios. Los nombres del grupo de medios deben ser únicos dentro del ámbito de una base de datos RSM única.

[in] lpMediaType

Identificador del tipo de medio en este grupo de medios. Use la función EnumerateNtmsObject para obtener una lista de los tipos de medios disponibles y sus atributos. La aplicación puede pasar un puntero NULL para crear un grupo de medios que contenga solo otros grupos de medios.

[in] dwAction

Acción que se va a realizar. Este parámetro puede ser uno de los siguientes valores.

Value Significado
NTMS_OPEN_EXISTING
 Abre un grupo de medios existente por nombre. Devuelve ERROR_OBJECT_NOT_FOUND si el grupo no existe.
NTMS_OPEN_ALWAYS
 Abre un grupo de medios existente o crea el grupo si no existe.
NTMS_CREATE_NEW
 Crea un nuevo grupo de medios. Devuelve ERROR_ALREADY_EXISTS si el grupo existe.

[in] lpSecurityAttributes

Descriptor de seguridad opcional que se usa para restringir el acceso al grupo.

[out] lpPoolId

Puntero a una variable que recibe el identificador único del grupo de medios después de que el grupo de medios se haya creado o abierto correctamente.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS al grupo raíz o al grupo de medios primario se deniega al intentar crear un nuevo grupo de medios. 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 primario se deniega al intentar crear un nuevo grupo de medios. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad.
ERROR_ALREADY_EXISTS
 No se puede crear un nuevo grupo de medios porque ya existe con este nombre.
ERROR_DATABASE_FAILURE
 La base de datos es inaccesible o está dañada.
ERROR_DATABASE_FULL
 La base de datos está llena. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_INVALID_MEDIA
 El tipo de medio seleccionado no es válido.
ERROR_INVALID_NAME
 La sintaxis del nombre del grupo no es válida. (El nombre es demasiado largo).
ERROR_INVALID_PARAMETER
 Falta el nombre del grupo de medios o el puntero de identificador del grupo de medios.
ERROR_OBJECT_NOT_FOUND
 No se puede abrir el grupo de medios existente.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

RSM crea grupos de medios gratuitos, no reconocidos e importados y no se pueden crear con la función CreateNtmsMediaPool .

Los grupos de medios de RSM se organizan como una jerarquía separada por el carácter "". Los grupos de medios de importación, aplicación, gratis, no reconocido e importación existen en la raíz de la jerarquía. RSM crea y administra los grupos gratis, no reconocidos e importar. RSM crea un grupo de medios gratis para cada tipo de medio disponible.

Las aplicaciones crean grupos de medios específicos de la aplicación. Las aplicaciones crean grupos de medios para su propio uso en el grupo de aplicaciones raíz. Estos grupos de medios tienen nombres similares al sistema de archivos. Solo el punto final del nombre contiene medios y directivas. Una aplicación puede definir grupos como \MyApp\Pool1 y \MyApp\Pool2. Esto transmite la jerarquía a la interfaz de usuario y evita nombres duplicados. Cada nivel de grupo debe crearse individualmente; primero MyApp y, a continuación, Pool1 y Pool2, como carpetas y archivos.

Windows Server 2003: Para crear un grupo de medios, debe tener NTMS_CONTROL_ACCESS al grupo raíz y al grupo primario. Si no se proporciona un descriptor de seguridad, el grupo hereda los ACA de su grupo primario (si el grupo primario no es el grupo raíz). Además, las cuentas del sistema local y creador tienen acceso total al grupo. Si el grupo primario es el grupo raíz, sus ACE no se heredan; los únicos ACA de la DACL tienen acceso total a las cuentas de sistema local y creador.

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

AllocateNtmsMedia

DeleteNtmsMediaPool

GetNtmsObjectSecurity

Funciones de Media Services

SetNtmsObjectSecurity