Compartilhar via


Método IMDSPStorage::GetName (mswmdm.h)

O método GetName recupera o nome de exibição do objeto de armazenamento.

Sintaxe

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

Parâmetros

[out] pwszName

Ponteiro para uma cadeia de caracteres largos (Unicode) terminada em nulo contendo o nome do objeto.

[in] nMaxChars

Inteiro que contém o número máximo de caracteres que podem ser copiados para a cadeia de caracteres de nome.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

  • Códigos de erro COM padrão
  • Códigos de erro do Windows convertidos em valores HRESULT
  • Códigos de erro de Gerenciador de Dispositivos do Windows Media
Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

O nome de exibição do objeto é o nome do arquivo sem informações de caminho. Na mídia hierárquica, o nome de exibição seria concatenado com as instâncias ancestrais das interfaces IMDSPStorage para criar um nome completo qualificado por caminho.

O tipo de cadeia de caracteres LPWSTR é uma cadeia de caracteres Unicode de 16 bits e não aceita caracteres do tamanho de bytes.

Esse método deve ser implementado. Ele não deve retornar WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

IMDSPStorage Interface

IMDSPStorage::GetDate

IMDSPStorage::GetSize