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

Artigo
02/29/2024

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.