Edit

IMDSPStorage::GetName method (mswmdm.h)

  • Article

The GetName method retrieves the display name of the storage object.

Syntax

HRESULT GetName(
  [out] LPWSTR pwszName,
  [in]  UINT   nMaxChars
);

Parameters

[out] pwszName

Pointer to a (Unicode) wide-character null-terminated string containing the object name.

[in] nMaxChars

Integer containing the maximum number of characters that can be copied to the name string.

Return value

The method returns an HRESULT. All the interface methods in Windows Media Device Manager can return any of the following classes of error codes:

  • Standard COM error codes
  • Windows error codes converted to HRESULT values
  • Windows Media Device Manager error codes
For an extensive list of possible error codes, see Error Codes.

Remarks

The display name of the object is the file name without path information. In hierarchical media the display name would be concatenated with the ancestor instances of IMDSPStorage interfaces to create a full path-qualified name.

The LPWSTR string type is a 16-bit Unicode character string and does not accept byte-sized characters.

This method must be implemented. It must not return WMDM_E_NOTSUPPORTED or E_NOTIMPL. For more information, see Mandatory and Optional Interfaces.

Requirements

Requirement Value
Target Platform Windows
Header mswmdm.h
Library Mssachlp.lib

See also

IMDSPStorage Interface

IMDSPStorage::GetDate

IMDSPStorage::GetSize