Función CreateNtmsMediaPoolW (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 aplicación.

Sintaxis

DWORD CreateNtmsMediaPoolW(
  [in]  HANDLE                hSession,
  [in]  LPCWSTR               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 cree o abra 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. También se pueden producir otros errores de seguridad, pero indicarían un error del subsistema de seguridad.

Windows XP: NTMS_MODIFY_ACCESS al grupo de medios primario se deniega al intentar crear un nuevo grupo de medios. También se pueden producir otros errores de seguridad, pero indicarían un error del 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 no es accesible o está dañada.
ERROR_DATABASE_FULL
 La base de datos está llena. También se pueden producir otros errores de seguridad, pero indicarían un error del 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 gratuita, no reconocida e importación existen en la raíz de la jerarquía. RSM crea y administra los grupos de importación, no reconocidos y gratuitos. 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, de forma muy similar a las carpetas y los 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 ACE 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; las únicas ACE de la DACL tienen acceso total a las cuentas del sistema local y creador.

Nota

El encabezado ntmsapi.h define CreateNtmsMediaPool como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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