Platform SDK: Removable Storage Manager

DeleteNtmsDrive

The DeleteNtmsDrive function deletes a drive from the RSM database. The drive must have a dwOperationalState of NTMS_NOT_PRESENT.

DWORD WINAPI DeleteNtmsDrive(
  HANDLE hSession, 
  LPNTMS_GUID lpDriveId
);

Parameters

hSession
Handle to the session returned by the OpenNtmsSession function.
lpDriveId
Specifies the unique identifier of a drive.

Return Values

Value Meaning
ERROR_ACCESS_DENIED NTMS_MODIFY_ACCESS to the library is denied. Other security errors are also 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_DRIVE The drive identifier is invalid.
ERROR_INVALID_HANDLE The session handle is invalid or missing.
ERROR_INVALID_LIBRARY The drive library identifier is invalid.
ERROR_INVALID_PARAMETER The media identifier is missing.
ERROR_NOT_ENOUGH_MEMORY An allocation failure occurred during processing.
ERROR_SUCCESS The function was successful.

Remarks

You can use this function to remove drives that are no longer connected to the RSM server.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Ntmsapi.h.
  Library: Use Ntmsapi.lib.

See Also

Library Control Functions