AddNtmsMediaType function (ntmsapi.h)

  • Article

[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]

The AddNtmsMediaType function adds the specified media type to the specified library if there is not currently a relation in the library object. The function then creates the system media pools if they do not exist.

Syntax

DWORD AddNtmsMediaType(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaTypeId,
  [in] LPNTMS_GUID lpLibId
);

Parameters

[in] hSession

Handle to the session returned by the OpenNtmsSession function.

[in] lpMediaTypeId

Unique identifier of the media type to add to the library.

[in] lpLibId

Unique identifier of the library to which the media type will be added.

Return value

This function returns one of the following values.

Value Meaning
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS to the library is denied. Other security errors are possible, but they would indicate a security subsystem error.

Windows XP:  NTMS_CONTROL_ACCESS to the library is denied. Other security errors are possible, but they would indicate a security subsystem error.
ERROR_DATABASE_FAILURE
 The database is inaccessible or damaged.
ERROR_DATABASE_FULL
 The database is full.
ERROR_INVALID_HANDLE
 The session handle is missing or is not valid.
ERROR_INVALID_LIBRARY
 The library ID is not valid.
ERROR_INVALID_MEDIA
 The media type is not valid.
ERROR_INVALID_PARAMETER
 The media type or library ID is missing.
ERROR_NOT_ENOUGH_MEMORY
 There was an allocation failure during processing.
ERROR_SUCCESS
 The function was successful.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header ntmsapi.h
Library Ntmsapi.lib
DLL Ntmsapi.dll

See also

DeleteNtmsMediaType

Media Services Functions