IWMDMOperation::GetObjectName (deprecated)
![]() |
This is preliminary documentation and subject to change.
This topic documents a feature of the Windows Media Device Manager SDK. We recommend that you migrate your application to use the Windows Portable Devices API. For more information, see the Windows Portable Devices SDK.
Windows Media Device Manager calls GetObjectName before an object is written to the device in order to know what it should be named on the device.
Syntax
HRESULT GetObjectName(
LPWSTR pwszName,
UINT nMaxChars
);
Parameters
pwszName
[out] Pointer to a wide-character null-terminated string that specifies the object name. The name should include a file extension, if required. Windows Media Device Manager allocates and releases this buffer. nMaxChars specifies the maximum number of characters, including the terminating null character.
nMaxChars
[in] Integer specifying the number of characters in pwszName, including the terminating null character.
Return Values
The application should return one of the following HRESULT values.
Return code | Description |
S_OK | The read operation should continue. |
WMDM_E_USER_CANCELLED | The read operation should be cancelled without finishing. |
E_FAIL | An unspecified error occurred, and the read operation should be cancelled without finishing. |
If the application returns either E_FAIL or WMDM_E_USER_CANCELLED is returned from this call, the operation is cancelled and the End method is called. If the application is using block mode and returns WMDM_E_USER_CANCELLED, then Windows Media Device Manager will return that error to the application.
Remarks
This method is only called if the application did not specify the name as a parameter in the Insert method.
Requirements
Header: Defined in mswmdm.h.
Library: mssachlp.lib
See Also