|
|
| Previous | Next |
The Delete method permanently removes specified content from a storage medium.
Syntax
HRESULT Delete(
UINT fuMode,
IWMDMProgress* pProgress
);
Parameters
fuMode
[in] Specifies whether the Delete operation is to be carried out in block or thread mode, and whether it should be recursive if the the storage object is a folder. Specify exactly one of the first two modes; if both are specified, block mode is used.
| Mode | Description |
| WMDM_MODE_BLOCK | The operation will be performed using block mode processing. The call will not return until the operation is completed. |
| WMDM_MODE_THREAD | The operation will be performed using thread mode processing. The call will return immediately, and the operation will be performed in a background thread. |
| WMDM_MODE_RECURSIVE | If the storage object is a folder, it and its contents, and all subfolders and their contents are deleted. |
pProgress
[in] Pointer to an IWMDMProgress interface to be used by Windows Media Device Manager to report progress back to the application. The pProgress argument can be NULL.
Return Values
If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.
| Return code | Description |
| WMDM_E_INTERFACEDEAD | The file or folder was previously deleted. |
| E_BUSY | The media device is already busy with another operation. |
| E_INVALIDARG | A parameter is invalid or is a NULL pointer. |
| E_FAIL | An unspecified error occurred. |
Remarks
If WMDM_MODE_BLOCK is specified, the Delete method does not return until the deletion is complete. If the WMDM_MODE_THREAD is specified, the call returns immediately, and the caller can use the IWMDMStorageGlobals::GetStatus function to track the deletion operation.
Upon completion of the delete operation, the IWMDMStorage and IWMDMStorageControl interfaces, as well as any other interfaces derived from the IWMDMStorage interface that represented the object, are no longer valid. The application must release these interfaces and any other interfaces or resources associated with the object (content).
See Also
| Previous | Next |