AddNtmsMediaType Function
[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
hSession [in]
Handle to the session returned by the OpenNtmsSession function.lpMediaTypeId [in]
Unique identifier of the media type to add to the library.lpLibId [in]
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.
|
| 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
Minimum supported client |
Windows 2000 Professional |
Minimum supported server |
Windows 2000 Server |
End of client support |
Windows Vista |
End of server support |
Windows Server 2008 |
Header |
Ntmsapi.h |
Library |
Ntmsapi.lib |
DLL |
Ntmsapi.dll |
See Also
Send comments about this topic to Microsoft
Build date: 6/9/2011